persona-author

Author and validate schema-conformant ADD persona files for agent routing and judgment.

19|5|Updated May 29, 2026
One-click install
npx skills add https://github.com/pilotspace/ADD --skill persona-author-pilotspace
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: persona-author
Source: https://github.com/pilotspace/ADD/tree/main/add-method/skill/add/persona-author
Command: npx skills add https://github.com/pilotspace/ADD --skill persona-author-pilotspace

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) and assets (resource) components.

What problem does it solve? Writing a domain-expert persona for the ADD engine is easy to get wrong: a persona that misses the engine's contract is never loaded, and one that duplicates the agent's own voice or output contract is dead weight. This Skill guides authoring, seeding, and validating persona files so they route correctly and carry real judgment. ## Core Features & Use Cases - Schema-guided authoring: Produces personas with the required sections (Identity, Critical Rules, Default Requirement, Success Metrics) plus recommended frontmatter (flow, task-kinds, use-when, not-when) that the ADD engine validates and routes on. - Seeding from existing sources: Distills a first draft from the teacher persona library or a sample subagent file instead of starting from a blank page, with explicit source-to-schema mappings. - Judgment-layer patterns: Applies twelve distilled patterns (earned-perspective identity, bold-lead rules, qualification gate, failure-aware metrics, escalation stances) that separate an expert lens from a keyword list. - Use Case: When no existing persona fits a new task kind (e.g., a payments-integration lens), use this Skill to seed from the nearest teacher persona, write the judgment sections, and validate with add doctor until the persona appears in the compiled roster. ## Quick Start Use the persona-author skill to draft a new ADD persona for payment integration work, seeded from the nearest teacher persona, and validate it with add doctor.

Frequently Asked Questions about persona-author

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I author a new ADD persona file?▼

Create a kebab-case slug file at .add/personas/<slug>.md with required frontmatter (name, vibe) and required sections (Identity, Critical Rules, Default Requirement, Success Metrics). Then run add doctor to confirm no findings and doctor --sync to verify it appears in the compiled roster.

How do I seed a persona from an existing teacher or subagent file?▼

Pick the nearest teacher persona in .add/personas-teacher/ or a sample subagent from ~/.claude/agents/, then apply the source-to-schema mapping in references/seeding.md. Carry over structure, distil the judgment, and add the columns sources never supply like failure-aware Success Metrics and not-when.

What sections are required in an ADD persona?▼

The engine requires four sections: Identity, Critical Rules, Default Requirement, and Success Metrics. Abilities is recommended so surfaces can run the lens's orient commands, while Anti-patterns, Playbook, and Escalation are optional.

Why is my persona not loaded by any ADD surface?▼

The most common cause is a flow value outside the four valid ones (design, build, advisor, verify), which fails silently because the engine does not lint routing fields. Also check for leftover angle-bracket placeholders and confirm the persona appears in .add/index.md after doctor --sync.

When should I fold into an existing persona instead of authoring a new one?▼

Fold when a sibling persona almost fits and the gap is a lesson worth keeping, recorded via its folded frontmatter line. Author a new persona only when no sibling owns the seam, since a roster of near-duplicates is worse than one sharp lens.