skill-architect
Installation
SKILL.md
Skill Architect
Architect portable, high-quality agent skills from a vendor-neutral perspective. Use this skill as an independent planning, creation, review, refactoring, comparison, distillation, reconciliation, and teaching layer for any agent skill repository or runtime.
Command modes
Use command-like modes when the user names one explicitly. If no mode is named, infer the closest mode from the request and state the assumption.
| Mode | Use when | Primary reference | Output |
|---|---|---|---|
skill-architect: plan |
Designing a skill, repo standard, gate, release, or migration before editing | Portable rubric, Naming and packaging | Scope, affected files, standards, verification path, rollback notes |
skill-architect: create |
Creating a new portable skill or scaffolding a skill folder | Portable rubric | SKILL.md plus linked references/assets/scripts and repo metadata plan |
skill-architect: audit |
Reviewing an existing skill or skill repo against the rubric | Portable rubric | Source-cited findings table, mechanical gate status, patch recommendations |
skill-architect: fix |
Applying narrow deterministic fixes that validate_skill.py can prove |
Portable rubric | Dry-run patch list or applied safe fixes, then validation output |
skill-architect: refactor |
Improving an existing skill without changing its purpose | Portable rubric, Eval methodology | Trigger rewrite, reference split, routing cleanup, verification updates |
skill-architect: compare |
Comparing upstream skill-development, authoring, or creator rubrics | Comparative study | Evidence matrix, reusable rules, adoption/rejection decisions |
skill-architect: distill |
Reviewing one session, a session ID/path, or a group of sessions to extract a reusable skill | Eval methodology, Portable rubric | Session evidence map, reusable workflow, skill proposal or draft, eval plan |
skill-architect: reconcile |
Refreshing stale skill plans, audits, session-distilled proposals, or blocked skill backlogs | Eval methodology, Portable rubric | Updated status, drift decisions, retired/reopened items, next executable plan |
skill-architect: teach |
Explaining skill authoring standards or coaching a user/agent | Portable rubric, Vendor adapters | Concise lesson, examples, and next-step exercise or checklist |