majiayu000/agent-curator
| Deep curation of a single agent definition through structured human conversation. Coordinates knowledge research, persona refinement, tooling optimization, and instruction quality improvement. One agent at a time, with due care.
npx skills add https://github.com/majiayu000/claude-skill-registry --skill agent-curatorInvoke for ad-hoc agent curation or project preparation:
[ACTIVATE:AGENT_CURATOR_V1]
Parameters:
agent: path/to/agent.md
mode: broad | project
project: {project-name} # Required if mode=project
Drive a structured conversation to deeply improve an agent definition across all dimensions:
For general agent enhancement:
For preparing an agent for a specific project:
Present scope selection:
╔═══════════════════════════════════════════════════════════════════════╗
║ AGENT CURATION SESSION ║
╠═══════════════════════════════════════════════════════════════════════╣
║ ║
║ Agent: {agent-name} ║
║ Tier: {focused | expert | phd} ║
║ Current File: {path} ║
║ ║
║ What is the goal of this curation session? ║
║ ║
║ [B] Broad Improvement ║
║ Enhance general effectiveness across all use cases ║
║ Changes are candidates for upstream contribution ║
║ ║
║ [P] Project-Specific Preparation ║
║ Optimize for: {project-name if provided} ║
║ May include project-specific knowledge/tooling ║
║ ║
╚═══════════════════════════════════════════════════════════════════════╝
Wait for human selection before proceeding.
Load and analyze the agent definition:
╔═══════════════════════════════════════════════════════════════════════╗
║ INITIAL ASSESSMENT ║
╠═══════════════════════════════════════════════════════════════════════╣
║ ║
║ Agent: {agent-name} ║
║ Mode: {Broad | Project-Specific} ║
║ ║
║ ┌────────────────────────────────────────────────────────────────┐ ║
║ │ DIMENSION SCORES │ ║
║ ├────────────────────────────────────────────────────────────────┤ ║
║ │ Knowledge Sources [██░░░] 2/5 HIGH gap │ ║
║ │ Persona & Doctrine [████░] 4/5 LOW gap │ ║
║ │ Tooling & MCP [███░░] 3/5 MEDIUM gap │ ║
║ │ Local Corpora [█░░░░] 1/5 HIGH gap │ ║
║ │ Instruction Quality [████░] 4/5 LOW gap │ ║
║ └────────────────────────────────────────────────────────────────┘ ║
║ ║
║ Key Observations: ║
║ • {observation-1} ║
║ • {observation-2} ║
║ • {observation-3} ║
║ ║
║ Recommended Focus: Knowledge Sources, Local Corpora ║
║ ║
╠═══════════════════════════════════════════════════════════════════════╣
║ [C] Continue with full curation ║
║ [F] Focus on high-gap dimensions only ║
║ [S] Skip to specific phase ║
╚═══════════════════════════════════════════════════════════════════════╝
╔═══════════════════════════════════════════════════════════════════════╗
║ KNOWLEDGE SOURCES — CURRENT STATE ║
╠═══════════════════════════════════════════════════════════════════════╣
║ ║
║ ┌────────────────────────────────────────────────────────────────┐ ║
║ │ EXISTING SOURCES │ ║
║ ├────────────────────────────────────────────────────────────────┤ ║
║ │ ✓ {url-1} │ ║
║ │ Authority: Official | Status: 200 OK | Unique Value: Yes │ ║
║ │ │ ║
║ │ ⚠ {url-2} │ ║
║ │ Authority: Community | Status: 200 OK | Unique Value: ? │ ║
║ │ │ ║
║ │ ✗ {url-3} │ ║
║ │ Authority: Vendor | Status: 404 | Action: Remove │ ║
║ └────────────────────────────────────────────────────────────────┘ ║
║ ║
║ Issues Found: ║
║ • 1 broken URL ║
║ • 2 sources with unclear unique value ║
║ • Missing: authoritative specification references ║
║ ║
╠═══════════════════════════════════════════════════════════════════════╣
║ [R] Research new sources ║
║ [A] Address issues (remove broken, evaluate unclear) ║
║ [N] Next phase (no changes) ║
╚═══════════════════════════════════════════════════════════════════════╝
Delegate to agent-knowledge-researcher and web-researcher:
Researching authoritative sources for: {agent-domain}
Using Opus to identify esteemed references...
Using Firecrawl for parallel discovery...
Evaluating:
• Official documentation sites
• Specification repositories
• Academic papers (if applicable)
• Vendor documentation
Present EACH source individually for human decision:
╔═══════════════════════════════════════════════════════════════════════╗
║ SOURCE ADJUDICATION (1 of N) ║
╠═══════════════════════════════════════════════════════════════════════╣
║ ║
║ Source: {source-title} ║
║ URL: {url} ║
║ Authority: {tier} ({tier-name}) ║
║ ║
║ Unique Value: ║
║ {explanation of what this provides that nothing else does} ║
║ ║
║ Materialization Recommendation: {URL | Local Excerpt | Embed} ║
║ Rationale: {why this materialization} ║
║ ║
╠═══════════════════════════════════════════════════════════════════════╣
║ [A] Add with recommended materialization ║
║ [M] Add with different materialization ║
║ [S] Skip this source ║
║ [D] Show more details ║
╚═══════════════════════════════════════════════════════════════════════╝
Repeat for each source. Never bulk-add.
╔═══════════════════════════════════════════════════════════════════════╗
║ PERSONA & DOCTRINE ║
╠═══════════════════════════════════════════════════════════════════════╣
║ ║
║ ┌────────────────────────────────────────────────────────────────┐ ║
║ │ CURRENT INTERPRETIVE LENS │ ║
║ ├────────────────────────────────────────────────────────────────┤ ║
║ │ {current lens text} │ ║
║ └────────────────────────────────────────────────────────────────┘ ║
║ ║
║ Assessment: {Good | Needs sharpening | Missing} ║
║ ║
║ ┌────────────────────────────────────────────────────────────────┐ ║
║ │ PROPOSED IMPROVEMENT │ ║
║ ├────────────────────────────────────────────────────────────────┤ ║
║ │ {proposed improved lens} │ ║
║ └────────────────────────────────────────────────────────────────┘ ║
║ ║
║ Rationale: {why this is better} ║
║ ║
╠═══════════════════════════════════════════════════════════════════════╣
║ [A] Accept improvement ║
║ [K] Keep current ║
║ [E] Edit proposal ║
╚═══════════════════════════════════════════════════════════════════════╝
Similarly for vocabulary calibration and core principles.
╔═══════════════════════════════════════════════════════════════════════╗
║ TOOLING & MCP ║
╠═══════════════════════════════════════════════════════════════════════╣
║ ║
║ Current Tool Modes: ║
║ audit: {tools} ║
║ solution: {tools} ║
║ research: {tools} ║
║ ║
║ Current MCP Servers: ║
║ • {server-1}: {purpose} ║
║ • {server-2}: {purpose} ║
║ ║
║ Recommendations: ║
║ [+] Add MCP server: {server} ║
║ Rationale: {why this would help} ║
║ ║
║ [~] Modify tool mode: {mode} ║
║ Proposal: {change} ║
║ ║
╠═══════════════════════════════════════════════════════════════════════╣
║ Review each recommendation? [Y/n] ║
╚═══════════════════════════════════════════════════════════════════════╝
╔═══════════════════════════════════════════════════════════════════════╗
║ LOCAL CORPORA ║
╠═══════════════════════════════════════════════════════════════════════╣
║ ║
║ Materialization Candidates: ║
║ ║
║ 1. {knowledge-topic} ║
║ From: {source} ║
║ Size: ~{token-estimate} tokens ║
║ Stability: {stable | slow-decay | fast-decay} ║
║ Recommendation: {Materialize | Keep as URL} ║
║ ║
║ 2. {knowledge-topic-2} ║
║ ... ║
║ ║
╠═══════════════════════════════════════════════════════════════════════╣
║ [R] Review each candidate ║
║ [A] Accept all recommended ║
║ [N] No local materialization ║
╚═══════════════════════════════════════════════════════════════════════╝
╔═══════════════════════════════════════════════════════════════════════╗
║ INSTRUCTION QUALITY ║
╠═══════════════════════════════════════════════════════════════════════╣
║ ║
║ Findings: ║
║ ║
║ [HIGH] Instruction Interference ║
║ P1.5 conflicts with P2.3 on {topic} ║
║ Proposed resolution: {resolution} ║
║ ║
║ [MEDIUM] Missing Cognitive Mode ║
║ Convergent mode not defined ║
║ Proposed: {mode definition} ║
║ ║
║ [LOW] Escalation Calibration ║
║ Threshold may be too high for this domain ║
║ Proposed: Lower from 0.7 to 0.6 ║
║ ║
╠═══════════════════════════════════════════════════════════════════════╣
║ [R] Review each finding ║
║ [H] Address HIGH severity only ║
║ [N] No instruction changes ║
╚═══════════════════════════════════════════════════════════════════════╝
╔═══════════════════════════════════════════════════════════════════════╗
║ CURATION COMPLETE ║
╠═══════════════════════════════════════════════════════════════════════╣
║ ║
║ Agent: {agent-name} ║
║ Mode: {Broad | Project-Specific} ║
║ ║
║ Changes Summary: ║
║ Knowledge: +3 sources, -1 broken, 2 URLs validated ║
║ Persona: Interpretive lens sharpened ║
║ Tooling: +1 MCP server (firecrawl) ║
║ Corpora: 1 local excerpt added ║
║ Instructions: 1 conflict resolved, 1 mode added ║
║ ║
║ Score Improvement: ║
║ Knowledge: 2/5 → 4/5 ║
║ Persona: 4/5 → 5/5 ║
║ Tooling: 3/5 → 4/5 ║
║ Corpora: 1/5 → 3/5 ║
║ Instructions: 4/5 → 5/5 ║
║ ║
╠═══════════════════════════════════════════════════════════════════════╣
║ [S] Save updated definition ║
║ [R] Review changes before saving ║
║ [C] Cancel (discard all changes) ║
╚═══════════════════════════════════════════════════════════════════════╝
╔═══════════════════════════════════════════════════════════════════════╗
║ CONTRIBUTE UPSTREAM? ║
╠═══════════════════════════════════════════════════════════════════════╣
║ ║
║ These improvements may benefit other users of this agent. ║
║ ║
║ Would you like to contribute to the upstream agents repo? ║
║ ║
║ [Y] Yes - Prepare PR to turbobeest/agents ║
║ [N] No - Keep improvements local only ║
║ ║
╚═══════════════════════════════════════════════════════════════════════╝
This skill uses the agent-curation-orchestrator to:
agent-knowledge-researcher for source discoveryweb-researcher for Firecrawl-based research| Signal | Meaning |
|--------|---------|
| CURATION_STARTED | Session begun for agent |
| CURATION_PHASE_COMPLETE | Individual phase finished |
| CURATION_COMPLETE | All phases done, agent updated |
| CURATION_CANCELLED | Session cancelled, no changes |
During project phases, this skill can be invoked to prepare agents:
Phase 6 Pre-Gate: Preparing for specification work
The typescript-pro agent will be used.
Would you like to curate it for this project? [Y/n]
[ACTIVATE:AGENT_CURATOR_V1]
agent: agents/-03-agents/.../typescript-pro.md
mode: project
project: {current-project-name}
Outputs:
.claude/curation-logs/Next: Resume normal operations or continue with phase work.
Take majiayu000/agent-curator from the repository into ~/.claude/skills for personal
use, or into .claude/skills inside a project.
The agent identifies a skill by the name field in its header. Two skills with the
same name cannot sit side by side — one of them will be ignored.