docs-search

Docs Search

This skill searches and retrieves Apps-in-Toss documentation. This skill ax CLI binary via a run-ax.sh shell script.

How to run

Inside this skill directory, run-ax.shis executed with bash. The script automatically downloads and caches the ax binary, so no separate installation is required.

# macOS / Linux
bash skills/docs-search/run-ax.sh <command> [flags]

# Windows (PowerShell)
pwsh skills/docs-search/run-ax.ps1 <command> [flags]

Commands

1. search — document search

You can search three document sources:

Subcommand	Source
`search docs`	Apps-in-Toss Developer Center
`search tds-rn`	TDS React Native
`search tds-web`	TDS Web

Flags:

--query "검색어" (required) — search keyword
--limit N (optional, default 10) — maximum number of results

Example:

# 앱인토스 개발 문서에서 "미니앱 개발" 검색 (최대 5건)
bash skills/docs-search/run-ax.sh search docs --query "미니앱 개발" --limit 5

# TDS React Native에서 Button 컴포넌트 검색
bash skills/docs-search/run-ax.sh search tds-rn --query "Button component" --limit 3

# TDS Web에서 Toast 사용법 검색
bash skills/docs-search/run-ax.sh search tds-web --query "Toast usage" --limit 3

Output format (JSON array):

[
  {
    "id": "134c4bc8dc67f01e",
    "title": "미니앱 출시",
    "content": "문서 내용 스니펫...",
    "description": "",
    "url": "https://developers-apps-in-toss.toss.im/development/deploy.md",
    "category": "Table of Contents > 출시 > 출시하기",
    "score": 0.4259
  }
]

For each result, idcan be used to retrieve the full document.

2. get — retrieve document/example

From the search results, idretrieves the full content of a document or example.

Subcommand	Description
`get doc --id "ID"`	Retrieve Apps-in-Toss documentation
`get tds-rn --id "ID"`	Retrieve TDS React Native documentation
`get tds-web --id "ID"`	Retrieve TDS Web documentation
`get example --id "ID"`	Retrieve example code

Example:

# 검색 결과에서 얻은 id로 문서 전체 조회
bash skills/docs-search/run-ax.sh get doc --id "134c4bc8dc67f01e"

# TDS React Native 문서 조회
bash skills/docs-search/run-ax.sh get tds-rn --id "<id>"

# 예제 코드 조회
bash skills/docs-search/run-ax.sh get example --id "7a4d6538fecee2f4"

Output format (JSON object):

{
  "id": "134c4bc8dc67f01e",
  "title": "미니앱 출시",
  "content": "문서 전체 내용 (마크다운)...",
  "url": "https://developers-apps-in-toss.toss.im/development/deploy.md",
  "category": "Table of Contents > 출시 > 출시하기"
}

3. list — resource list

# 예제 목록 조회
bash skills/docs-search/run-ax.sh list examples

Workflow

When the user asks an Apps-in-Toss-related question, proceed in the following order:

Search: search docs/tds-rn/tds-webto find relevant documents and obtain idacquire
Retrieve: get doc/tds-rn/tds-web --idto check the full document content
Answer: Answer the user based on the retrieved document

Example workflow:

# Step 1: 검색
bash skills/docs-search/run-ax.sh search docs --query "인앱 결제" --limit 3

# Step 2: 결과에서 id 확인 후 전체 문서 조회
bash skills/docs-search/run-ax.sh get doc --id "<검색결과의-id>"

Version

run-ax.shautomatically detects the latest ax CLI version via the GitHub Releases API. Version information is cached for 24 hours, and if the API call fails, the cached version or fallback version is used.