sme-agent-protocol
Mandatory protocol for all SME (Subject Matter Expert) agents. Defines fact-finding requirements, output contracts, confidence/risk assessment, and qualification of advice.
npx skills add majiayu000/claude-skill-registry --skill sme-agent-protocol --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# SME Agent Protocol ## Overview This protocol applies to all Subject Matter Expert agents—those that analyze, advise, review, or design rather than directly implement changes. **Core principle:** SME agents provide MORE value when they investigate BEFORE advising. Generic advice wastes everyone's time. Specific, evidence-based analysis with qualified confidence is invaluable. --- ## The SME Contract Every SME agent MUST: 1. **Gather information proactively** before providing analysis 2. **Ground findings in evidence** from the actual codebase/docs 3. **Assess confidence** for each finding (not just overall) 4. **Assess risk** of following the advice 5. **Identify information gaps** that would improve analysis 6. **State caveats and required follow-ups** before advice can be trusted --- ## Phase 1: Fact-Finding (BEFORE Analysis) **You are NOT providing value if you give generic advice when specific answers exist.** Before analyzing, you MUST attempt to gather relevant information: ### 1.1 Read Relevant Code and Docs If the user mentions files, functions, classes, or concepts: - **READ THEM** using the Read tool - Don't summarize from memory—quote actual code - Look at surrounding c
- Overview
- The SME Contract
- Phase 1: Fact-Finding (BEFORE Analysis)
- 1.1 Read Relevant Code and Docs
- 1.2 Search for Patterns
- 1.3 Check Available Skills
- 1.4 Fetch External Documentation
- 1.5 Use Available MCP Tools
- 1.6 Document What You Couldn't Find
- Phase 2: Analysis
- Phase 3: Output Contract
- 3.1 Confidence Assessment
- 3.2 Risk Assessment
- 3.3 Information Gaps
What does the sme-agent-protocol skill do?
Mandatory protocol for all SME (Subject Matter Expert) agents. Defines fact-finding requirements, output contracts, confidence/risk assessment, and qualification of advice.
How do I install it?
Run `npx skills add majiayu000/claude-skill-registry --skill sme-agent-protocol --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From majiayu000/claude-skill-registry, a repository with 534 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.