docs-search
Search and retrieve Toss / Apps-in-Toss documentation using the ax CLI via run-ax.sh. Supports docs, TDS React Native, and TDS Web sources. Use bash to execute run-ax.sh in this skill's directory.
- Installs
- 43
- Last 24h
- —
- Trending rank
- —
- Security
- Not audited
Install
Works with every agent the skills CLI supports.
npx skills add https://github.com/toss/apps-in-toss-skills --skill docs-search- 01
Install
Run the command in your project. The CLI asks which agents to install for.
- 02
Describe the task
Ask your agent for something this skill covers. It loads docs-search automatically when relevant.
- 03
Review the result
The agent follows the SKILL.md steps, scripts and references bundled with the skill.
SKILL.md
The instructions your agent reads when the skill is triggered.
Docs Search
Apps-in-Toss 문서를 검색하고 조회하는 스킬입니다.
이 스킬은 ax CLI 바이너리를 run-ax.sh 셸 스크립트를 통해 실행합니다.
How to run
이 스킬 디렉토리 안의 run-ax.sh를 bash로 실행합니다.
스크립트가 ax 바이너리를 자동으로 다운로드·캐싱하므로 별도 설치는 필요 없습니다.
# 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 — 문서 검색
세 가지 문서 소스를 검색할 수 있습니다:
| 서브커맨드 | 소스 |
|---|---|
search docs | Apps-in-Toss Developer Center |
search tds-rn | TDS React Native |
search tds-web | TDS Web |
플래그:
--query "검색어"(필수) — 검색 키워드--limit N(선택, 기본값 10) — 최대 결과 수
예시:
# 앱인토스 개발 문서에서 "미니앱 개발" 검색 (최대 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
출력 형식 (JSON 배열):
[
{
"id": "134c4bc8dc67f01e",
"title": "미니앱 출시",
"content": "문서 내용 스니펫...",
"description": "",
"url": "https://developers-apps-in-toss.toss.im/development/deploy.md",
"category": "Table of Contents > 출시 > 출시하기",
"score": 0.4259
}
]
각 결과의 id를 사용하여 문서 전체를 조회할 수 있습니다.
2. get — 문서/예제 조회
검색 결과의 id로 문서 또는 예제의 전체 내용을 조회합니다.
| 서브커맨드 | 설명 |
|---|---|
get doc --id "ID" | Apps-in-Toss 문서 조회 |
get tds-rn --id "ID" | TDS React Native 문서 조회 |
get tds-web --id "ID" | TDS Web 문서 조회 |
get example --id "ID" | 예제 코드 조회 |
예시:
# 검색 결과에서 얻은 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"
출력 형식 (JSON 객체):
{
"id": "134c4bc8dc67f01e",
"title": "미니앱 출시",
"content": "문서 전체 내용 (마크다운)...",
"url": "https://developers-apps-in-toss.toss.im/development/deploy.md",
"category": "Table of Contents > 출시 > 출시하기"
}
3. list — 리소스 목록
# 예제 목록 조회
bash skills/docs-search/run-ax.sh list examples
Workflow
사용자가 앱인토스 관련 질문을 하면 아래 순서로 진행합니다:
- 검색:
search docs/tds-rn/tds-web로 관련 문서를 찾고id를 획득 - 조회:
get doc/tds-rn/tds-web --id로 문서 전체 내용을 확인 - 답변: 조회한 문서를 바탕으로 사용자에게 답변
예시 워크플로우:
# 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.sh는 GitHub Releases API를 통해 최신 ax CLI 버전을 자동으로 감지합니다.
버전 정보는 24시간 동안 캐시되며, API 호출 실패 시 캐시된 버전 또는 fallback 버전을 사용합니다.
FAQ
What does the docs-search skill do?
Search and retrieve Toss / Apps-in-Toss documentation using the ax CLI via run-ax.sh. Supports docs, TDS React Native, and TDS Web sources. Use bash to execute run-ax.sh in this skill's directory.
How do I install docs-search?
Run npx skills add https://github.com/toss/apps-in-toss-skills --skill docs-search in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/docs-search/ (personal) or .claude/skills/docs-search/ (project).
Which AI agents can use docs-search?
Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.
Is docs-search safe to install?
No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.
Who maintains docs-search?
It is published by toss in toss/apps-in-toss-skills. It has 43 recorded installs.
Popular docs & writing skills
grill-with-docs
mattpocock/skills
A relentless interview to sharpen a plan or design, which also creates docs (ADR's and glossary) as we go.
lark-markdown
open.feishu.cn
飞书 Markdown：查看、创建、上传、编辑和比较飞书中的原生 Markdown 文件。当用户要操作飞书 Markdown 文件，或比较其远端版本及本地草稿时使用。纯本地 Markdown 文件操作不触发本 skill。不负责将 Markdown 导入为飞书在线文档，也不负责文件搜索、权限、评论、移动、删除等云空间管理操作。
writing-beats
mattpocock/skills
Writing, exploit; assemble raw material into a journey of beats, grounding each term before a beat leans on it.
writing-shape
mattpocock/skills
Writing, exploit: shape raw material into an article, paragraph by paragraph.
writing-fragments
mattpocock/skills
Writing, explore: mine raw fragments, no structure yet.
writing-for-agents
mattpocock/skills
Writing documents for agents. Use when creating or editing skills, or modifying AGENTS.md or CLAUDE.md.