Agent skill

Doc Search

by jellydn in jellydn/my-ai-tools

Search project documentation — ADRs, wiki entries, conventions via ripgrep, qmd, fff, and ctx

MITAuto-check passedKnowledge Management

Install Doc Search

skills CLI
$ npx skills add jellydn/my-ai-tools --skill doc-search -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install jellydn/my-ai-tools doc-search --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/jellydn/my-ai-tools.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/doc-search .claude/skills/doc-search && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
doc-search
GitHub stars
123
Token cost
~1.4k tokens
SKILL.md length
421 words
Files
1
Skills in repo
33
Repo updated
First seen
Licence
MIT

At a glance

Search project documentation — ADRs, wiki entries, conventions via ripgrep, qmd, fff, and ctx

  • Works in 4 steps: Find Relevant Documents → Query Knowledge Base → Search Past Sessions → …
  • Tasks that involve Architecture decision records
  • SKILL.md covers When to Use, What It Does, Where Documentation Lives and How to Search, plus 4 more sections
  • Calls rg

What it does

Doc Search is an agent skill from jellydn/my-ai-tools. Search project documentation — ADRs, wiki entries, conventions via ripgrep, qmd, fff, and ctx

Its SKILL.md is about 1.4k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts. Compatibility notes: cline, claude, opencode, amp, codex, gemini, cursor, pi

It sits in Knowledge Management, covering Architecture decision records. The repository describes itself as: Comprehensive configuration management for AI coding tools - Replicate my complete setup for Claude Code, OpenCode, Amp, Li, Codex and Claude Code Switch with custom… The licence is MIT.

When your agent uses it

  • Tasks that involve Architecture decision records

Example prompts

  • “/doc-search”

Requirements

  • Compatibility (from SKILL.md): cline, claude, opencode, amp, codex, gemini, cursor, pi

Workflow steps

4 steps, taken from the step headings in SKILL.md.

  1. Find Relevant Documents
  2. Query Knowledge Base
  3. Search Past Sessions
  4. Explore by Pattern

What it can do on your machine

Read from SKILL.md and the folder at commit 62c9227. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • rg

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

  • Compatibility

    cline, claude, opencode, amp, codex, gemini, cursor, pi

    From compatibility in the SKILL.md frontmatter.

Context cost

Doc Search loads about 1.4k tokens when it runs. Until then it costs about 26 tokens; SKILL.md has 421 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~26
When it runs · the whole SKILL.md, loaded when a task matches
~1.4k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from jellydn/my-ai-tools at commit 62c9227, republished under its MIT licence (© jellydn). 421 words, ~1,370 tokens.

Download SKILL.mdSave it as .claude/skills/doc-search/SKILL.md (or your agent's skills folder).
name
doc-search
description
Search project documentation — ADRs, wiki entries, conventions via ripgrep, qmd, fff, and ctx
compatibility
cline, claude, opencode, amp, codex, gemini, cursor, pi
license
MIT
hint
Use when you need to find existing documentation before writing new docs
user-invocable
true

When to Use

Use this skill when:

  • Starting work on a feature that may have existing decisions or ADRs
  • Need to understand project conventions or patterns
  • Looking for past design discussions or trade-off analyses
  • Want to find relevant wiki entries or knowledge base articles
  • Need to understand how existing documentation is structured
  • Planning to write documentation and want to match existing style

What It Does

Helps you find and navigate existing project documentation using available tools (grep, qmd, fff, ctx). Documentation is often scattered across multiple locations — this skill provides a systematic approach to find what you need.

Where Documentation Lives

This project stores documentation in several locations:

LocationContentBest For
docs/User-facing guides (quick-start, tutorials)Getting started, feature guides
ADRs via configs/adr/*Architecture Decision RecordsWhy decisions were made
wiki/LLM wiki — entities, concepts, logKnowledge base, cross-references
MEMORY.mdDurable project learnings and gotchasKnown issues, conventions
skills/*/SKILL.mdAgent skill definitionsTool capabilities
configs/*.mdTool-specific documentationPer-tool behavior
AGENTS.mdAgent instructions and guidelinesDevelopment workflow
qmd knowledge baseIndexed project knowledgeSearchable, AI-powered retrieval
Step 1: Find Relevant Documents

Use fff to locate documentation files:

bash
fff "*.md" docs/         # All documentation files
fff "*adr*"              # Architecture Decision Records
fff "*auth*" docs/       # Auth-related documentation
fff "*wiki*"             # Wiki entries

Use rg (ripgrep) to search documentation content:

bash
rg "decision" docs/                   # Find decisions in docs
rg "ADR-0" . --glob "*.md"           # Find ADR references
rg "rate.limiting" --glob "*.md"     # Find docs about rate limiting
Step 2: Query Knowledge Base

Use qmd to search durable project knowledge:

bash
qmd search "authentication decisions"     # Find related knowledge
qmd query "What architecture exists for X?"  # Get structured answers
qmd get ADR-001                           # Get a specific ADR

The qmd knowledge base indexes project learnings, ADRs, conventions, and gotchas that persist across agent sessions.

Step 3: Search Past Sessions

Use ctx to find previous discussions about documentation:

bash
ctx search "documentation" "decision"       # Past doc discussions
ctx search "ADR" "architecture" path/docs/  # Past ADR discussions
ctx search "convention" "pattern"            # Past convention discussions
Step 4: Explore by Pattern

Project documentation follows consistent patterns:

Architecture Decision Records (ADRs):

bash
# Find all ADRs
ls -la docs/adr/
# Search ADR content
rg "decision" docs/adr/

Wiki entries:

bash
# Browse wiki structure
ls -la wiki/wiki/entities/
ls -la wiki/wiki/concepts/
# Search wiki content
rg "topic" wiki/wiki/ --glob "*.md"

Agent skills:

bash
# Find skill documentation
rg "what.*does" skills/*/SKILL.md
# Find skills by category
rg "compatibility:.*auth" skills/*/SKILL.md
Show full SKILL.md (163 more words)Show less

Understanding Documentation Style

Before writing new documentation, study existing examples:

  1. Pick a reference: Find an existing doc on a similar topic
  2. Analyze structure: Note heading levels, code blocks, tables
  3. Check tone: Is it formal, conversational, or technical?
  4. Match conventions: Use the same formatting patterns

Example: If you need to write an ADR, read an existing ADR first:

bash
fff "*adr*.md"   # Find existing ADRs
cat docs/adr/001-some-decision.md  # Read as reference

Documentation Discovery Workflow

Before writing:
1. Search existing docs for related content
2. Check qmd for existing knowledge
3. Search ctx for past discussions
4. Read existing docs for style reference

During writing:
5. Link to relevant ADRs and decisions
6. Reference existing conventions
7. Cross-link related documentation

After writing:
8. Add to wiki or qmd knowledge base
9. Reference from relevant agent instructions
10. Update docs-update skill if patterns changed

Integration with Other Skills

  • docs-update: Use doc-search first to find what exists before updating
  • context-discovery: Documentation search is part of context discovery
  • implementation-logger: Extract learnings into documentation
  • qmd-knowledge: Add new knowledge to durable storage
  • llm-wiki: Build and maintain wiki entries from findings

Tips

  • Search before writing: Always check if documentation already exists
  • Follow existing patterns: Match the style of existing docs
  • Cross-link: Reference ADRs, wiki entries, and related docs
  • Update qmd: After finding useful documentation, index it in qmd
  • Use rg over grep: ripgrep is faster and respects .gitignore
  • Check wiki/ first: The LLM wiki is designed for discoverability

© jellydn, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/doc-search of jellydn/my-ai-tools.

Open the folder on GitHubat commit 62c9227

Compare with similar skills

Doc Search next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Doc Search compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Doc Search this skilljellydn/my-ai-tools123—~1.4kAutomated safety check: PassMIT
Grasp Knowledgedykyi-roman/awesome-claude-code104—~1.4kAutomated safety check: PassMIT
Exploremirumee/nimara-ecommerce129—~436Automated safety check: PassBSD-3-Clause
Research Lintiusztinpaul/ai-research-os-workshop179—~2.3kAutomated safety check: PassMIT
New LoopAI-Builder-Club/skills1.3k—~1.2kAutomated safety check: NotesNone
Pi Reviewnatsukium/dotfiles106—~972Automated safety check: PassCC0-1.0

Similar skills

  • Grasp Knowledge

    dykyi-roman/awesome-claude-code

    GRASP principles knowledge base for PHP 8.4 projects. An agent skill from dykyi-roman/awesome-claude-code.

    104 GitHub stars~1.4k tokensUpdated 1 mo ago
    Knowledge ManagementAuto-check passed
  • Explore

    mirumee/nimara-ecommerce

    Ways to explore llm-wiki and answer from it. An agent skill from mirumee/nimara-ecommerce.

    129 GitHub stars~436 tokensUpdated today
    Knowledge ManagementAuto-check passed
  • Research Lint

    iusztinpaul/ai-research-os-workshop

    Health-check a research directory produced by /research. An agent skill from iusztinpaul/ai-research-os-workshop.

    179 GitHub stars~2.3k tokensUpdated 3 mo ago
    Knowledge ManagementAuto-check passed
  • New Loop

    AI-Builder-Club/skills

    Spin up a new loop (domain) in a file-based knowledge base — bootstrap the substrate if it's missing, gather the loop's charter, scaffold domains/<loop/README.md, then do ONE real test run and…

    1.3k GitHub stars~1.2k tokensUpdated 24 days ago
    Knowledge ManagementAuto-check: notes
  • Pi Review

    natsukium/dotfiles

    Delegate a source-grounded design or code review to a fresh pi CLI process using sol or luna, then address verified findings until no blockers remain.

    106 GitHub stars~972 tokensUpdated today
    Knowledge ManagementAuto-check passed
  • Kdrive Sentry Rca

    Infomaniak/desktop-kDrive

    Investigate kDrive crashes, Sentry issues, and application logs to produce source-grounded root cause analyses.

    120 GitHub stars~4.1k tokensUpdated today
    Knowledge ManagementAuto-check passed

More from jellydn/my-ai-tools

All 33 skills in this repo
  • Babysit PR

    jellydn/my-ai-tools

    A skill your agent uses when monitoring an open GitHub PR for CI failures, review feedback, mergeability, and safe retries or fixes.

    123 GitHub stars~4.1k tokensUpdated today
    Auto-check passed
  • Visual PR

    jellydn/my-ai-tools

    Posts a concise visual outline as a GitHub pull request comment.

    123 GitHub stars~764 tokensUpdated today
    Auto-check passed
  • Qmd Knowledge

    jellydn/my-ai-tools

    Manage project knowledge with qmd — captures learnings, decisions, and conventions

    123 GitHub stars~2.1k tokensUpdated today
    Auto-check passed
  • Prd

    jellydn/my-ai-tools

    Generate Product Requirements Documents from feature ideas — plans specs and requirements

    123 GitHub starsUsed in 4 repos~1.8k tokens
    Auto-check passed
  • Capability Experiments

    jellydn/my-ai-tools

    Build an interactive report or experiment when the user asks to explore model capabilities.

    123 GitHub stars~2k tokensUpdated today
    Auto-check passed
  • PR Review

    jellydn/my-ai-tools

    Fix PR review comments by implementing requested changes. An agent skill from jellydn/my-ai-tools.

    123 GitHub stars~1.1k tokensUpdated today
    Auto-check passed

Questions about Doc Search

What does Doc Search do?

Search project documentation — ADRs, wiki entries, conventions via ripgrep, qmd, fff, and ctx. Doc Search is an agent skill from jellydn/my-ai-tools.

When should I use Doc Search?

Doc Search fits situations like: tasks that involve Architecture decision records.

How do I install Doc Search in Claude Code?

Run `npx skills add jellydn/my-ai-tools --skill doc-search -a claude-code`. Or copy the skill folder (skills/doc-search in jellydn/my-ai-tools) into .claude/skills/doc-search in your project. Claude Code loads it when a task matches its description.

How do I install Doc Search in Codex?

Run `npx skills add jellydn/my-ai-tools --skill doc-search -a codex`. Or copy the skill folder (skills/doc-search in jellydn/my-ai-tools) into .agents/skills/doc-search in your project. Codex loads it when a task matches its description.

Can I use Doc Search in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add jellydn/my-ai-tools --skill doc-search -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/doc-search, .gemini/skills/doc-search, .github/skills/doc-search and .opencode/skills/doc-search in your project.

What does Doc Search need to run?

Going by SKILL.md and its folder, Doc Search needs the command-line tools its instructions call (rg). Compatibility (from SKILL.md): cline, claude, opencode, amp, codex, gemini, cursor, pi.

Does Doc Search access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Doc Search safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Doc Search use?

Doc Search is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Doc Search use?

About 1.4k tokens (SKILL.md is roughly 5.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Doc Search?

Skills that share tags, products or a category with Doc Search: Grasp Knowledge (dykyi-roman/awesome-claude-code, 104 stars), Explore (mirumee/nimara-ecommerce, 129 stars), Research Lint (iusztinpaul/ai-research-os-workshop, 179 stars) and New Loop (AI-Builder-Club/skills, 1.3k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Doc Search?

jellydn (a GitHub user) maintains it in jellydn/my-ai-tools, which has 123 GitHub stars. The repository holds 33 skills in this directory. The repository was last updated on October 10, 2026.

Source: jellydn/my-ai-tools on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.