Agent skill

Doc QA

by larry-zy in larry-zy/cognida

“文档问答技能,从知识库中语义检索相关文档片段并据此作答,附带来源引用。”

— description from SKILL.md by larry-zy
MITAuto-check passed

Install Doc QA

skills CLI
$ npx skills add larry-zy/cognida --skill doc-qa -a claude-code

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

GitHub CLI
$ gh skill install larry-zy/cognida doc-qa --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/larry-zy/cognida.git skills-src && mkdir -p .claude/skills && cp -r skills-src/services/cognida-go/skills/doc-qa .claude/skills/doc-qa && 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-qa
GitHub stars
182
Token cost
~210 tokens
SKILL.md length
24 words
Files
1
Skills in repo
9
Repo updated
First seen
Licence
MIT

At a glance

  • SKILL.md covers 何时用 / 何时不用, 标准流程, 工具 and 约束
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

About this skill

Doc QA is a skill in larry-zy/cognida (182 stars). Its SKILL.md is about 210 tokens. Licence: MIT.

What it can do on your machine

Read from SKILL.md and the folder at commit bf76257. 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

    No scripts in the folder and no shell commands in SKILL.md (its code samples are json).

    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.

Context cost

Doc QA loads about 210 tokens when it runs. Until then it costs about 11 tokens; SKILL.md has 24 words of instructions outside code blocks.

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

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 larry-zy/cognida at commit bf76257, republished under its MIT licence (© larry-zy). 24 words, ~210 tokens.

Download SKILL.mdSave it as .claude/skills/doc-qa/SKILL.md (or your agent's skills folder).
name
doc-qa
description
文档问答技能,从知识库中语义检索相关文档片段并据此作答,附带来源引用。
when_to_use
当用户的问题需要从知识库/文档中查找答案(如“文档里怎么说的”“检索一下相关资料”),依赖非结构化文本内容而非数据库取数时使用。
category
retrieval
tags
rag, doc-qa, retrieval, knowledge-base
version
1.0.0
author
Cognida Team

文档问答(Doc QA)

面向「从知识库检索文档片段并据此回答」的场景。区别于图谱检索(查实体关系)与取数(查数据库)。

何时用 / 何时不用

  • ✅ 用:答案在文档/资料里,需要语义检索文本片段后归纳作答。
  • ❌ 不用:
    • 查实体之间的关系 / 血缘 / 上下游 → graph-retrieval
    • 查数据库里的数字/明细 → text2sql-adhoc / semantic-metric

标准流程

1. 理解问题意图,提炼检索 query
   ↓
2. rag_query 语义检索相关文档片段
   ↓
3. 依据检索内容归纳作答,不足则换 query 重检
   ↓
4. 标注引用来源(文档/片段)

工具

rag_query — 知识库语义检索
json
{ "tool": "rag_query", "parameters": { "query": "退货政策的时限是多少天" } }

约束

  • 回答只基于检索到的内容;检索为空或不足时如实说明,不要编造。
  • 命中片段与用户问题弱相关时,改写 query 再检一次。
  • 给出来源引用,便于溯源核对。

© larry-zy, 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 services/cognida-go/skills/doc-qa of larry-zy/cognida.

Open the folder on GitHubat commit bf76257

Compare with similar skills

Doc QA 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 QA compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Doc QA this skilllarry-zy/cognida182—~210Automated safety check: PassMIT
Docnexu-io/open-design100k—~266Automated safety check: PassApache-2.0
Doctermio-sh/termio537—~2kAutomated safety check: PassMIT
Docboshu2/agentops4481 repos~1.9kAutomated safety check: PassApache-2.0
Dockv0906/pm-kit138—~472Automated safety check: NotesMIT
DocleanEthereum/leanSpec143—~1.9kAutomated safety check: PassMIT

Similar skills

  • Doc

    nexu-io/open-design

    Read, create, and edit .docx documents with formatting and layout fidelity via OpenAI's document skill.

    100k GitHub stars~266 tokensUpdated today
    Documents & OfficeAuto-check passed
  • Doc

    termio-sh/termio

    A skill your agent uses for ANY operation on a doc under docs/ — creating, updating/editing, changing its status, or querying.

    537 GitHub stars~2k tokensUpdated today
    DevelopmentAuto-check passed
  • Doc

    boshu2/agentops

    Write or update READMEs, docs, repo instructions and handoff notes, checked against source.

    448 GitHub starsUsed in 1 repo~1.9k tokens
    Agent WorkflowsAuto-check passed
  • Doc

    kv0906/pm-kit

    Draft or edit a document — PRD, spec, design doc, technical brief.

    138 GitHub stars~472 tokensUpdated 3 mo ago
    Product & Project ManagementAuto-check: notes
  • Doc

    leanEthereum/leanSpec

    Document code in this repository.

    143 GitHub stars~1.9k tokensUpdated 1 mo ago
    DevelopmentAuto-check passed
  • Doc

    Sikao-Engine/KimiX

    Guide for navigating and maintaining Kimix project documentation.

    114 GitHub stars~1.1k tokensUpdated today
    DevelopmentAuto-check passed

More from larry-zy/cognida

All 9 skills in this repo
  • Attribution Analysis

    larry-zy/cognida

    归因/根因分析技能,把指标的期间变化拆解到候选维度,定位驱动因子并给出置信与下钻建议. An agent skill from larry-zy/cognida.

    182 GitHub stars~524 tokensUpdated 1 mo ago
    Auto-check passed
  • Report Composition

    larry-zy/cognida

    综合报告生成技能,把多段取数(总览+趋势+分群等)整合成一份带洞察的结构化报告. An agent skill from larry-zy/cognida.

    182 GitHub stars~397 tokensUpdated 1 mo ago
    Auto-check passed
  • Semantic Metric

    larry-zy/cognida

    语义指标取数技能,先查治理好的指标语义模型,再按统一口径取指标,避免对物理表猜测. An agent skill from larry-zy/cognida.

    182 GitHub stars~329 tokensUpdated 1 mo ago
    Auto-check passed
  • Generate a comprehensive report of core e-commerce operating metrics (GMV, orders, average order value, repurchase)

    182 GitHub stars~470 tokensUpdated 1 mo ago
    Auto-check passed
  • Graph Retrieval

    larry-zy/cognida

    图谱与血缘检索技能,查询实体之间的关系、上下游依赖与数据血缘。

    182 GitHub stars~236 tokensUpdated 1 mo ago
    Auto-check passed
  • Text2sql Adhoc

    larry-zy/cognida

    即席取数技能,把一句话的具体数据问题翻译成 SQL 并执行返回结果。

    182 GitHub stars~390 tokensUpdated 1 mo ago
    Auto-check passed

Questions about Doc QA

How do I install Doc QA in Claude Code?

Run `npx skills add larry-zy/cognida --skill doc-qa -a claude-code`. Or copy the skill folder (services/cognida-go/skills/doc-qa in larry-zy/cognida) into .claude/skills/doc-qa in your project. Claude Code loads it when a task matches its description.

How do I install Doc QA in Codex?

Run `npx skills add larry-zy/cognida --skill doc-qa -a codex`. Or copy the skill folder (services/cognida-go/skills/doc-qa in larry-zy/cognida) into .agents/skills/doc-qa in your project. Codex loads it when a task matches its description.

Can I use Doc QA 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 larry-zy/cognida --skill doc-qa -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-qa, .gemini/skills/doc-qa, .github/skills/doc-qa and .opencode/skills/doc-qa in your project.

What does Doc QA need to run?

SKILL.md names no scripts, command-line tools or credentials: Doc QA is instructions for the agent only.

Does Doc QA 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 QA 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 QA use?

Doc QA is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Doc QA use?

About 210 tokens (SKILL.md is roughly 840 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 QA?

Skills that share tags, products or a category with Doc QA: Doc (nexu-io/open-design, 100k stars), Doc (termio-sh/termio, 537 stars), Doc (boshu2/agentops, 448 stars) and Doc (kv0906/pm-kit, 138 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Doc QA?

larry-zy (a GitHub user) maintains it in larry-zy/cognida, which has 182 GitHub stars. The repository holds 9 skills in this directory. The repository was last updated on August 31, 2026.

Source: larry-zy/cognida on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.