Reskill

Context

When the coordinator hears "team, reskill" (or similar: "optimize context", "slim down charters"), trigger a team-wide optimization pass. The goal: reduce per-agent context consumption by extracting shared patterns from charters and histories into reusable skills.

This is a periodic maintenance activity. Run whenever charter/history bloat is suspected or a team will be re-cast. Charters and histories are evidence, not the authority for current product behavior: reconcile candidates against current source, workflows, tests, documentation, skills, and decisions before preserving them.

Process

Step 1: Audit

Read all active agent charters and histories, then inventory existing skills. Measure byte sizes. Identify:

• Boilerplate — sections repeated across ≥3 charters with <10% variation (collaboration, model, boundaries template)
• Shared knowledge — domain knowledge duplicated in 2+ charters (incident postmortems, technical patterns)
• Mature learnings — recurring history lessons that should be promoted to skills
• Retirement-critical knowledge — any still-current reusable procedure, constraint, incident lesson, or repository operating fact that would be lost if a charter or history were deleted

Step 2: Extract

For each reconciled pattern:

1. Create or update the skill in the location that matches its activation surface: .squad-templates/skills/{skill-name}/SKILL.md for reusable skills shipped in generated Squad templates, .github/skills/{skill-name}/SKILL.md for repository-local or GitHub Agentic Workflow procedures, or .squad/skills/{skill-name}/SKILL.md for Squad-specific coordinator procedures. Do not treat .copilot/skills/ as a destination for new skills; it is the legacy install path.
2. Follow the skill template format (frontmatter + Context + Patterns + Examples + Anti-Patterns)
3. Keep the location consistent with the procedure's real entry point instead of copying the same contract into multiple trees without intent
4. Set confidence from the evidence, not the number of charters that contained it

Step 3: Trim

Charters — target ≤1.5KB per agent:

• Remove Collaboration section entirely (spawn prompt + agent-collaboration skill covers it)
• Remove Voice section (tagline blockquote at top of charter already captures it)
• Trim Model section to single line: **Preferred:** {model}
• Remove "When I'm unsure" boilerplate from Boundaries
• Remove durable operating knowledge now covered by a skill — add a skill reference only when it helps the role activate the procedure
• Keep: Identity, What I Own, unique How I Work patterns, Boundaries (domain list only)

Histories — target ≤8KB per agent:

• Apply history-hygiene only when a retained history would otherwise assert a materially false operational fact
• Promote reusable current patterns even when found in one retiring charter or history
• Summarize old entries into ## Core Context section
• Remove session-specific metadata (dates, branch names, requester names)

For a planned re-cast, avoid cosmetic history rewrites. Extract the reusable lesson, document stale or conflicting material in the reskill report, and leave archival cleanup to the re-cast.