expertise-file-design

Installation
SKILL.md

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
Related skills
Installs
11
GitHub Stars
65
First Seen
Jan 24, 2026