expertise-file-design
Design YAML expertise file structures for agent experts. Use when creating mental models for domain-specific agents, defining expertise schema, or structuring knowledge for Act-Learn-Reuse workflows.
npx skills add majiayu000/claude-skill-registry --skill expertise-file-design --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.
# Expertise File Design Guide for designing YAML expertise files that serve as mental models for agent experts. ## MANDATORY: Act-Learn-Reuse Context Expertise files are **mental models**, NOT sources of truth. They: - Accelerate agent execution by pre-loading domain knowledge - Are maintained by self-improve prompts, not humans - Validate against the actual codebase (source of truth) - Have enforced line limits to protect context windows ## When to Use - Creating mental models for new domain-specific agents - Defining expertise schema structures (YAML) - Structuring knowledge for Act-Learn-Reuse workflows - Reviewing or auditing existing expertise file designs - Setting up line limits and section priorities ## Expertise File Structure ### Core Template ```yaml # {domain}/expertise.yaml # Mental model for {domain} agent expert # Last updated: {timestamp} # Lines: {current}/{max} overview: description: "Brief description of this domain" primary_technology: "Main tech/framework" architecture_pattern: "Key pattern used" core_implementation: main_module: file: "path/to/main/file.ext" lines: approximate_line_count purpose: "What this module does" key_exports: - name: "FunctionOrClass" t
- MANDATORY: Act-Learn-Reuse Context
- When to Use
- Expertise File Structure
- Core Template
- Line Limits
- Section Priority
- Domain-Specific Templates
- Database Domain
- API/Service Domain
- Frontend/UI Domain
- Seeding Strategy
- Anti-Patterns
- Validation Checklist
- Related Skills
What does the expertise-file-design skill do?
Design YAML expertise file structures for agent experts. Use when creating mental models for domain-specific agents, defining expertise schema, or structuring knowledge for Act-Learn-Reuse workflows.
How do I install it?
Run `npx skills add majiayu000/claude-skill-registry --skill expertise-file-design --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.