Claude Code Agent Development
anthropics/claude-plugins-official
Explains how to write agents for Claude Code plugins: the markdown file with YAML frontmatter, trigger descriptions, model and color settings, and system prompt design.
求是方法论的入口与总原则。在每次新的顶层会话开始时加载一次，用「实事求是」约束全部判断，并只在明确适用时把任务路由到对应的方法论 skill；被派遣执行单一具体任务的子 agent 直接跳过。
Install Arming Thought
$ npx skills add HughYau/qiushi-skill --skill arming-thought -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install HughYau/qiushi-skill arming-thought --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/HughYau/qiushi-skill.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/arming-thought .claude/skills/arming-thought && rm -rf skills-srcUse ~/.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/
Install the "arming-thought" agent skill from https://github.com/HughYau/qiushi-skill/tree/main/skills/arming-thought into .claude/skills/arming-thought/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "arming-thought", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/HughYau/qiushi-skill/tree/main/skills/arming-thoughtType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add HughYau/qiushi-skill --skill arming-thought -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install HughYau/qiushi-skill arming-thought --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/HughYau/qiushi-skill.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/arming-thought .agents/skills/arming-thought && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "arming-thought" agent skill from https://github.com/HughYau/qiushi-skill/tree/main/skills/arming-thought into .agents/skills/arming-thought/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "arming-thought", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add HughYau/qiushi-skill --skill arming-thought -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install HughYau/qiushi-skill arming-thought --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/HughYau/qiushi-skill.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/arming-thought .cursor/skills/arming-thought && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "arming-thought" agent skill from https://github.com/HughYau/qiushi-skill/tree/main/skills/arming-thought into .cursor/skills/arming-thought/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "arming-thought", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/HughYau/qiushi-skill.git --path skills/arming-thought--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add HughYau/qiushi-skill --skill arming-thought -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install HughYau/qiushi-skill arming-thought --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/HughYau/qiushi-skill.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/arming-thought .gemini/skills/arming-thought && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "arming-thought" agent skill from https://github.com/HughYau/qiushi-skill/tree/main/skills/arming-thought into .gemini/skills/arming-thought/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "arming-thought", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install HughYau/qiushi-skill arming-thoughtInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add HughYau/qiushi-skill --skill arming-thought -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/HughYau/qiushi-skill.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/arming-thought .github/skills/arming-thought && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "arming-thought" agent skill from https://github.com/HughYau/qiushi-skill/tree/main/skills/arming-thought into .github/skills/arming-thought/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "arming-thought", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add HughYau/qiushi-skill --skill arming-thought -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install HughYau/qiushi-skill arming-thought --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/HughYau/qiushi-skill.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/arming-thought .opencode/skills/arming-thought && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "arming-thought" agent skill from https://github.com/HughYau/qiushi-skill/tree/main/skills/arming-thought into .opencode/skills/arming-thought/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "arming-thought", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
arming-thought- GitHub stars
- 3.8k
- Token cost
- ~393 tokens
- SKILL.md length
- 73 words
- Files
- 1
- Skills in repo
- 11
- Repo updated
- First seen
- Licence
- MIT
At a glance
求是方法论的入口与总原则。在每次新的顶层会话开始时加载一次，用「实事求是」约束全部判断，并只在明确适用时把任务路由到对应的方法论 skill；被派遣执行单一具体任务的子 agent 直接跳过。
- Works in 3 steps: 一次只选一个主 skill，需要时再交接给第二个。 → 宿主已有等价流程（内置的… → 不为"形式完整"而机械调用；方法论只在能明显改善判断或行动时才用。
- Tasks that involve Subagents
- SKILL.md covers 总原则：实事求是（四条硬规则）, 路由：什么时候用哪件武器 and 指令优先级
- Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
What it does
Arming Thought is an agent skill from HughYau/qiushi-skill. 求是方法论的入口与总原则。在每次新的顶层会话开始时加载一次，用「实事求是」约束全部判断，并只在明确适用时把任务路由到对应的方法论 skill；被派遣执行单一具体任务的子 agent 直接跳过。 English: Entry point and governing principle of the Qiushi methodology. Load once at the start of a top-level session to enforce "seek truth from facts" and route to a downstream skill only when it clearly helps. Delegated sub-agents on narrow tasks should skip it.
Its SKILL.md is about 390 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.
It sits in Agent Workflows, covering Subagents. The repository describes itself as: Qiushi-Skill: Build agents that investigate first, focus on the main contradiction, validate in practice, and keep pushing until the work is actually done… The licence is MIT.
When your agent uses it
- Tasks that involve Subagents
Example prompts
- “seek truth from facts”
- “/arming-thought”
Workflow steps
3 steps, taken from the first numbered list in SKILL.md.
- 一次只选一个主 skill，需要时再交接给第二个。
- 宿主已有等价流程（内置的 plan、review、todo）时，以宿主流程为准，在其内部吸收方法论，不重复输出模板。
- 不为"形式完整"而机械调用；方法论只在能明显改善判断或行动时才用。
What it can do on your machine
Read from SKILL.md and the folder at commit 5ace717. 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.
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
Arming Thought loads about 393 tokens when it runs. Until then it costs about 94 tokens; SKILL.md has 73 words of instructions outside code blocks.
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 HughYau/qiushi-skill at commit 5ace717, republished under its MIT licence (© HughYau). 73 words, ~393 tokens.
Download SKILL.mdSave it as
.claude/skills/arming-thought/SKILL.md (or your agent's skills folder).- name
- arming-thought
- description
- 求是方法论的入口与总原则。在每次新的顶层会话开始时加载一次，用「实事求是」约束全部判断，并只在明确适用时把任务路由到对应的方法论 skill；被派遣执行单一具体任务的子 agent 直接跳过。 English: Entry point and governing principle of the Qiushi methodology. Load once at the start of a top-level session to enforce "seek truth from facts" and route to a downstream skill only when it clearly helps. Delegated sub-agents on narrow tasks should skip it.
武装思想
"'实事'就是客观存在着的一切事物，'是'就是客观事物的内部联系，即规律性，'求'就是我们去研究。" —— 《改造我们的学习》
子 agent 执行单一具体任务时：跳过本 skill。
总原则：实事求是（四条硬规则）
| 规则 | 做法 | 违反信号 |
|---|---|---|
| 结论跟着证据走 | 每个判断标出依据：读了什么、跑了什么、看到了什么 | 有判断，无依据 |
| 分清三种话 | 区分「已核实的事实」「推断」「未知」；未知就写"不知道，需确认" | 用猜测填空 |
| 验证过才算完成 | 声称完成前先跑一遍、看输出、比对预期，并写出验证动作 | 写完即宣布完成 |
| 遇阻先诊断 | 失败时先说清原因，再补调查或换路径；不在第一次受阻就停 | "超出能力范围"式放弃 |
事实与预想冲突时，改的是判断，不是事实。
路由：什么时候用哪件武器
先判断任务类型。直接执行类任务（改个名、格式化、按明确指令实现）不触发任何下游 skill，只吸收上面四条规则。
| 你遇到的情况 | 调用 |
|---|---|
| 要下判断，但事实、上下文不够 | investigation-first 调查研究 |
| 问题复杂、多头牵制、不知先解决什么 | contradiction-analysis 矛盾分析法 |
| 有了假说或方案，要验证、试错、迭代 | practice-cognition 实践认识论 |
| 多方意见分歧，或方案要带回真实使用者对齐 | mass-line 群众路线 |
| 工作做完了，要审视质量或处理批评 | criticism-self-criticism 批评与自我批评 |
| 任务长期、短期不可能速胜 | protracted-strategy 持久战略 |
| 多件事争抢注意力，要定主攻 | concentrate-forces 集中兵力 |
| 从零起步、资源极少、要选切入口 | spark-prairie-fire 星火燎原 |
| 多个目标互相牵制，要平衡 | overall-planning 统筹兼顾 |
| 明显要几件武器接力 | workflows 工作流组合 |
调用纪律：
- 一次只选一个主 skill，需要时再交接给第二个。
- 宿主已有等价流程（内置的 plan、review、todo）时，以宿主流程为准，在其内部吸收方法论，不重复输出模板。
- 不为"形式完整"而机械调用；方法论只在能明显改善判断或行动时才用。
指令优先级
用户明确指示 > 宿主平台的系统规则与安全约束 > 本方法论。
认真，但不机械。
© HughYau, 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/arming-thought of HughYau/qiushi-skill.
Open the folder on GitHubat commit 5ace717
Compare with similar skills
Arming Thought 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.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Arming Thought this skillHughYau/qiushi-skill | 3.8k | — | ~393 | Automated safety check: Pass | MIT | |
| Claude Code Agent Developmentanthropics/claude-plugins-official | 38k | 7 repos | ~2.8k | Automated safety check: Pass | Apache-2.0 | |
| Subagent Driven DevelopmentAsvarox/allkaraoke | 261 | 38 repos | ~1.2k | Automated safety check: Pass | None | |
| Dispatching Parallel Agentsultralisp/ultralisp | 258 | 41 repos | ~1.5k | Automated safety check: Pass | None | |
| Reflect on Session Learningscursor/plugins | 11k | 5 repos | ~1.2k | Automated safety check: Pass | None | |
| Paseo Advisor Second Opiniongetpaseo/paseo | 20k | 1 repos | ~756 | Automated safety check: Pass | Custom licence |
Similar skills
- Official
Subagent Driven Development
Asvarox/allkaraoke
A skill your agent uses when executing implementation plans with independent tasks in the current session
Dispatching Parallel Agents
ultralisp/ultralisp
A skill your agent uses when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies
- Official
Reflect on Session Learnings
cursor/plugins
Starts three parallel reviewer subagents over the current conversation transcript, then turns their findings into concrete edits to existing skills.
Paseo Advisor Second Opinion
getpaseo/paseo
Launches one separate agent through Paseo to give a second opinion on the current task, with a self-contained briefing and no permission to edit files.
Task Observer
rebelytics/one-skill-to-rule-them-all
Monitors task execution for skill improvement opportunities.
More from HughYau/qiushi-skill
All 11 skills in this repoConcentrate Forces
HughYau/qiushi-skill
集中兵力：多件事同时争抢时间、注意力或预算时，列出全部待办，选定唯一主攻目标并公开锁定，彻底解决、验证后再转向下一个。当待办过多、推进分散、"每件都做了一点但都没做完"、需要决定先做什么时触发；只有一个任务、任务彼此独立可并行、用户明确要求同时推进时不触发。
Contradiction Analysis
HughYau/qiushi-skill
矛盾分析法：把复杂问题拆成若干对立面，找出规定其他矛盾的主要矛盾及其主要方面，判定对抗性 / 非对抗性，并据此选择处理方式。当问题头绪多、多个因素互相牵制、优先级不清、根因不明、反复修不好、trade-off 说不清时触发；直接执行类任务或用户已定方案时不触发。
Criticism Self Criticism
HughYau/qiushi-skill
批评与自我批评：在工作完成、阶段验收、收到批评或同类错误反复出现时，对成果和过程做诚实、具体、基于事实的审视，输出可执行的改进项，并处理外来批评而不辩解。触发信号包括 review、复盘、审查、"帮我看看有没有问题"、"你确定吗"；任务刚开始或只是单步查询时不触发。
Investigation First
HughYau/qiushi-skill
调查研究：在下判断、做决策、给建议之前，先用第一手材料弄清现状，产出「事实 / 推断 / 未知」三栏调查结论。当上下文不完整、证据薄弱、领域陌生、用户说"先别动手"、或你发现自己在凭印象作答时触发；已充分调查后的执行阶段不要重复触发。
Mass Line
HughYau/qiushi-skill
群众路线：从持有真实情况的多方（用户、使用者、代码库、日志、运行结果）收集分散意见，系统化为方案，再带回去对齐与检验，循环改进。当多方意见分歧、需要汇总零散反馈、方案要拿回给真实使用者确认、或你发觉自己在闭门造车时触发；信息源单一且完整、处于执行阶段时不触发。
Overall Planning
HughYau/qiushi-skill
统筹兼顾：当多个目标、指标或利益方相互制约、优化一项会伤害另一项时，识别全部辩证关系对，检查片面性，为每对关系定出当前阶段的侧重与底线，评估系统性影响，并设失衡预警。触发信号包括 trade-off、目标冲突、速度 vs 质量、短期 vs 长期、"顾此失彼"；只有单一目标、用户已定取舍、或属硬性二选一时不触发。
Related
Categories
Questions about Arming Thought
What does Arming Thought do?
求是方法论的入口与总原则。在每次新的顶层会话开始时加载一次，用「实事求是」约束全部判断，并只在明确适用时把任务路由到对应的方法论 skill；被派遣执行单一具体任务的子 agent 直接跳过。. Arming Thought is an agent skill from HughYau/qiushi-skill. 求是方法论的入口与总原则。在每次新的顶层会话开始时加载一次，用「实事求是」约束全部判断，并只在明确适用时把任务路由到对应的方法论 skill；被派遣执行单一具体任务的子 agent 直接跳过。 English: Entry point and governing principle of the Qiushi methodology.
When should I use Arming Thought?
Arming Thought fits situations like: tasks that involve Subagents.
How do I install Arming Thought in Claude Code?
Run `npx skills add HughYau/qiushi-skill --skill arming-thought -a claude-code`. Or copy the skill folder (skills/arming-thought in HughYau/qiushi-skill) into .claude/skills/arming-thought in your project. Claude Code loads it when a task matches its description.
How do I install Arming Thought in Codex?
Run `npx skills add HughYau/qiushi-skill --skill arming-thought -a codex`. Or copy the skill folder (skills/arming-thought in HughYau/qiushi-skill) into .agents/skills/arming-thought in your project. Codex loads it when a task matches its description.
Can I use Arming Thought 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 HughYau/qiushi-skill --skill arming-thought -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/arming-thought, .gemini/skills/arming-thought, .github/skills/arming-thought and .opencode/skills/arming-thought in your project.
What does Arming Thought need to run?
SKILL.md names no scripts, command-line tools or credentials: Arming Thought is instructions for the agent only.
Does Arming Thought 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 Arming Thought 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 Arming Thought use?
Arming Thought 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 Arming Thought use?
About 393 tokens (SKILL.md is roughly 1.6k 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 Arming Thought?
Skills that share tags, products or a category with Arming Thought: Claude Code Agent Development (anthropics/claude-plugins-official, 38k stars), Subagent Driven Development (Asvarox/allkaraoke, 261 stars), Dispatching Parallel Agents (ultralisp/ultralisp, 258 stars) and Reflect on Session Learnings (cursor/plugins, 11k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Arming Thought?
HughYau (a GitHub user) maintains it in HughYau/qiushi-skill, which has 3,812 GitHub stars. The repository holds 11 skills in this directory. The repository was last updated on October 1, 2026.
Source: HughYau/qiushi-skill on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.