Add universal skills-creator package with scaffold and validator

docs/live/current-focus.md

@@ -4,25 +4,23 @@ Read after `AGENTS.md` when starting or resuming work. Keep this file limited to
 
 ## Objective
 
-Keep the first-party skill suite under `templates/base/.agents/skills/` organized around an owned routing model: a suite router (`using-agent-practices`), a reasoning-family router (`using-reasoning`), the existing leaf skills, and a shared category map that explains how the pieces fit together.
+Replace the legacy `create-skill` guidance with a production-ready, universal `skills-creator` package that matches the provided structure, scripts, and references for scaffolding, authoring, validating, and evaluating SKILL.md packages.
 
 ## Scope
 
-- Keep the new router skills under `templates/base/.agents/skills/using-agent-practices/` and `templates/base/.agents/skills/using-reasoning/`.
-- Keep the suite taxonomy reference under `templates/base/.agents/skills/using-agent-practices/references/category-map.md`.
-- Keep the starter skill-creator eval fixtures under each new router's `evals/evals.json`.
-- Keep the existing 11 live leaf skills in place without renaming them.
+- Work inside `templates/base/.agents/skills/skills-creator/` plus the live docs that track progress.
+- Include SKILL.md, `scripts/scaffold.py`, `scripts/validate.py`, `assets/skill_template.md`, `assets/eval_template.md`, and references for patterns, platforms, security, and antipatterns.
+- Retire the old `create-skill` folder; do not alter other skills or routers.
 
 ## Constraints
 
-- Use owned suite terminology; do not depend on third-party `superpowers` naming inside the first-party router skills.
-- Keep the skill directory flat for now; express categories through routers and references rather than nested discovery assumptions.
-- Preserve the existing leaf skill names and descriptions unless a future task explicitly asks to retune them.
-- Do not commit from this task.
+- Keep the skill universal across surfaces (no platform-bound instructions).
+- Follow the naming and validation rules from the specification (gerund form preferred, forbidden words, ≤64 chars, ≤500 body lines, ≤1-level references).
+- Preserve unrelated skills and existing router work.
 
 ## Success Criteria
 
-- `using-agent-practices/SKILL.md` routes across the current owned suite categories and points reasoning requests to `using-reasoning`.
-- `using-reasoning/SKILL.md` routes cleanly among `thinking-ground`, `problem-definition`, `dynamic-problem-solving`, `domain-expert-consultation`, and `strategic-foresight`.
-- Both router skills include starter `evals/evals.json` fixtures for future `skill-creator` iteration.
-- `using-agent-practices/references/category-map.md` records the suite categories and routing rule of thumb.
+- `skills-creator/SKILL.md` reflects the seven-phase lifecycle and progressive disclosure rules, with clear references to supporting files.
+- Scripts scaffold and validate skill packages per the naming/frontmatter/line-count rules.
+- Assets and references match the required templates and checklists.
+- Live docs reflect the updated objective and completed work.

docs/live/progress.md

@@ -4,11 +4,14 @@ Read after `docs/live/current-focus.md` to recover the latest state, continuity,
 
 ## Current State
 
-The first-party skill suite now has an owned routing layer. `using-agent-practices` routes across the whole suite, `using-reasoning` routes the overlapping reasoning skills, and `using-agent-practices/references/category-map.md` records the current category abstraction for the 11 live leaf skills.
+The legacy `create-skill` guidance has been replaced by a universal `skills-creator` package with SKILL.md, scripts, references, and templates for scaffolding, validating, and evaluating new skills.
 
 ## Latest Completed Work
 
-Created `templates/base/.agents/skills/using-agent-practices/SKILL.md`, `templates/base/.agents/skills/using-reasoning/SKILL.md`, a shared category map reference under `using-agent-practices/references/`, and starter `evals/evals.json` fixtures for both routers. The suite is now abstracted into Orchestration and Continuity, Reasoning and Strategy, Prompt Artifact Creation, Commercial Reality Testing, and Design Systems and Visual Prototyping, with only the reasoning cluster routed through a family router.
+- Added `templates/base/.agents/skills/skills-creator/SKILL.md` with the seven-phase lifecycle, progressive disclosure rules, and links to supporting resources.
+- Added assets (`skill_template.md`, `eval_template.md`) and references (`PATTERNS.md`, `PLATFORMS.md`, `SECURITY.md`, `ANTIPATTERNS.md`).
+- Implemented `scripts/scaffold.py` (name checks + scaffold + eval template copy) and `scripts/validate.py` (frontmatter/name/description/line-count/reference-depth checks, optional eval count gate).
+- Retired the old `create-skill` folder and refreshed live docs (current-focus, todo, progress).
 
 ## In Progress
 
@@ -20,24 +23,28 @@ None.
 
 ## Next Recommended Action
 
-If these routers will become stable entry points, run a true `skill-creator` eval loop against the new router skills next so the category ordering and descriptions can be pressure-tested on ambiguous prompts instead of only structurally validated.
+Author real evaluation scenarios for `skills-creator` (or downstream skills) and run the validator with `--full` once scenarios exist; optionally tune the gerund warning if keeping the `skills-creator` name as-is.
 
 ## Touched Files
 
-- `templates/base/.agents/skills/using-agent-practices/SKILL.md`
-- `templates/base/.agents/skills/using-agent-practices/references/category-map.md`
-- `templates/base/.agents/skills/using-agent-practices/evals/evals.json`
-- `templates/base/.agents/skills/using-reasoning/SKILL.md`
-- `templates/base/.agents/skills/using-reasoning/evals/evals.json`
+- `templates/base/.agents/skills/skills-creator/SKILL.md`
+- `templates/base/.agents/skills/skills-creator/assets/skill_template.md`
+- `templates/base/.agents/skills/skills-creator/assets/eval_template.md`
+- `templates/base/.agents/skills/skills-creator/references/PATTERNS.md`
+- `templates/base/.agents/skills/skills-creator/references/PLATFORMS.md`
+- `templates/base/.agents/skills/skills-creator/references/SECURITY.md`
+- `templates/base/.agents/skills/skills-creator/references/ANTIPATTERNS.md`
+- `templates/base/.agents/skills/skills-creator/scripts/scaffold.py`
+- `templates/base/.agents/skills/skills-creator/scripts/validate.py`
 - `docs/live/current-focus.md`
 - `docs/live/progress.md`
 - `docs/live/todo.md`
 
 ## Verification Status
 
-Read back both new SKILL files plus the new category map and eval fixtures. Ran and observed success for:
-- `python3` frontmatter/JSON validation covering `templates/base/.agents/skills/using-agent-practices/SKILL.md`, `templates/base/.agents/skills/using-reasoning/SKILL.md`, both router `evals/evals.json` files, and the required sections in `using-agent-practices/references/category-map.md`.
+- `python3 -m compileall templates/base/.agents/skills/skills-creator/scripts`
+- `python3 templates/base/.agents/skills/skills-creator/scripts/validate.py templates/base/.agents/skills/skills-creator` (passes with a gerund-name warning because the spec keeps `skills-creator`)
 
 ## Hand-off Note
 
-The suite abstraction is now documented without renaming the existing leaf skills. The next leverage point is evaluation quality, not more taxonomy: the owned routers exist, but their category order and trigger wording still need real ambiguous-prompt testing if you want them to become default entry points.
+`skills-creator` now packages the full lifecycle guidance plus scaffold/validate helpers and supporting references/templates. Add evaluation scenarios and re-run validation with `--full` when ready; adjust or silence the gerund warning if you prefer to keep the non-gerund name.

docs/live/todo.md

@@ -9,4 +9,5 @@ Use one row per work item. Prefer `High`, `Medium`, or `Low` for priority and `P
 | Task | Priority | Status |
 | --- | --- | --- |
 | Task 19: add owned suite routers and category map for the first-party skills | High | Completed |
-| Task 20: run `skill-creator` evaluations for `using-agent-practices` and `using-reasoning` on ambiguous prompts | Medium | Pending |
+| Task 20: run `skill-creator` evaluations for `using-agent-practices` and `using-reasoning` on ambiguous prompts | Medium | Pending |
+| Task 21: replace `create-skill` with the universal `skills-creator` package (SKILL, scripts, assets, references) | High | Active |