diff --git a/__init__.py b/__init__.py index 44574d4..077e2ad 100644 --- a/__init__.py +++ b/__init__.py @@ -1,7 +1,12 @@ +import re from pathlib import Path +DESCRIPTION = re.compile(r"^description:\s*([\"']?)(.*)\1\s*$", re.M) + def register(ctx): skills_dir = Path(__file__).parent / "skills" for skill_dir in sorted(p for p in skills_dir.iterdir() if (p / "SKILL.md").is_file()): - ctx.register_skill(skill_dir.name, skill_dir / "SKILL.md") + path = skill_dir / "SKILL.md" + match = DESCRIPTION.search(path.read_text(encoding="utf-8")) + ctx.register_skill(skill_dir.name, path, description=match.group(2) if match else "") diff --git a/plugin.yaml b/plugin.yaml index dc93df6..7244cde 100644 --- a/plugin.yaml +++ b/plugin.yaml @@ -1,4 +1,4 @@ name: pstack -version: "0.3.0" +version: "0.3.1" description: "Poteto's engineering rigor stack. Playbooks, principles, multi-model review." author: poteto (adapted by Madeleine) diff --git a/scripts/check_refs.py b/scripts/check_refs.py index 162152b..e031455 100644 --- a/scripts/check_refs.py +++ b/scripts/check_refs.py @@ -10,16 +10,32 @@ class Ctx: registered = [] - def register_skill(self, name, path): self.registered.append((name, Path(path))) + def register_skill(self, name, path, description="", **kwargs): self.registered.append((name, Path(path), description)) spec = importlib.util.spec_from_file_location("pstack_init", ROOT / "__init__.py") loader = importlib.util.module_from_spec(spec) spec.loader.exec_module(loader) loader.register(ctx := Ctx()) -for name, path in ctx.registered: +DANGLING = re.compile(r"(?: (?:and|or|a|the|with|of|to|for|from|that|your)|[:,.])\.$") +for name, path, description in ctx.registered: if path.name != "SKILL.md" or not path.is_file(): errors.append(f"__init__.py: {name} registered with {path}, not a SKILL.md file") -if {n for n, _ in ctx.registered} != SKILLS: + continue + text = path.read_text(encoding="utf-8") + m = re.search(r"^description:\s*([\"']?)(.*)\1\s*$", text.split("---", 2)[1] if text.startswith("---\n") else "", re.M) + if not text.startswith("---\n"): + errors.append(f"skills/{name}/SKILL.md: frontmatter must start with '---' on its own line") + if not description: + errors.append(f"__init__.py: {name} registered with empty description") + elif not m or description != m.group(2): + errors.append(f"__init__.py: {name} description differs from SKILL.md frontmatter") + if len(description) > 60: + errors.append(f"skills/{name}/SKILL.md: description over 60 chars") + if not description.endswith("."): + errors.append(f"skills/{name}/SKILL.md: description must end with a period") + if DANGLING.search(description): + errors.append(f"skills/{name}/SKILL.md: description looks cut mid-sentence: {description!r}") +if {n for n, _, _ in ctx.registered} != SKILLS: errors.append("__init__.py: registered skills differ from skills/ directories") CURSOR_LEFTOVERS = re.compile( @@ -58,8 +74,6 @@ def register_skill(self, name, path): self.registered.append((name, Path(path))) head = text.split("---", 2)[1] if text.startswith("---") else "" for field in ("name:", "description:", "version:", "author:", "license:", "platforms:", "metadata:", "hermes:", "tags:", "related_skills:"): if field not in head: errors.append(f"{path.relative_to(ROOT)}: missing frontmatter {field}") - m = re.search(r"^description:\s*[\"']?(.*?)[\"']?\s*$", head, re.M) - if m and len(m.group(1).strip('"')) > 60: errors.append(f"{path.relative_to(ROOT)}: description over 60 chars") if errors: print("\n".join(errors)); sys.exit(1) print(f"checked {len(files)} markdown files, {len(SKILLS)} skills") diff --git a/skills/architect/SKILL.md b/skills/architect/SKILL.md index 383dbb4..d84ec1e 100644 --- a/skills/architect/SKILL.md +++ b/skills/architect/SKILL.md @@ -1,4 +1,5 @@ ----name: architect +--- +name: architect description: "Design types and module structure before writing code." version: 0.1.0 author: poteto (Hermes adaptation) diff --git a/skills/automate-me/SKILL.md b/skills/automate-me/SKILL.md index 43173b8..83a8a87 100644 --- a/skills/automate-me/SKILL.md +++ b/skills/automate-me/SKILL.md @@ -1,5 +1,6 @@ ----name: automate-me -description: "Use for \"automate me\", \"create/update/refresh my." +--- +name: automate-me +description: "Use for 'automate me' or to build a personal -mode skill." version: 0.1.0 author: poteto (Hermes adaptation) license: MIT diff --git a/skills/blast-radius/SKILL.md b/skills/blast-radius/SKILL.md index 283449a..f30b47a 100644 --- a/skills/blast-radius/SKILL.md +++ b/skills/blast-radius/SKILL.md @@ -1,5 +1,6 @@ ----name: blast-radius -description: "Find what a change could break somewhere else before it." +--- +name: blast-radius +description: "Find what a change could break elsewhere before it ships." version: 0.1.0 author: poteto (Hermes adaptation) license: MIT diff --git a/skills/bro/SKILL.md b/skills/bro/SKILL.md index 98b5e09..ed5bd02 100644 --- a/skills/bro/SKILL.md +++ b/skills/bro/SKILL.md @@ -1,5 +1,6 @@ ----name: bro -description: "Restate the last message in plain human language, with." +--- +name: bro +description: "Use to restate your last message in plain human words." version: 0.1.0 author: poteto (Hermes adaptation) license: MIT diff --git a/skills/create-formal-verification-skill/SKILL.md b/skills/create-formal-verification-skill/SKILL.md index 031d0b7..8a116dc 100644 --- a/skills/create-formal-verification-skill/SKILL.md +++ b/skills/create-formal-verification-skill/SKILL.md @@ -1,4 +1,5 @@ ----name: create-formal-verification-skill +--- +name: create-formal-verification-skill description: "Generate a project-local formal verification skill." version: 0.1.0 author: poteto (Hermes adaptation) diff --git a/skills/create-verification-skill/SKILL.md b/skills/create-verification-skill/SKILL.md index 6ca6585..8cf2650 100644 --- a/skills/create-verification-skill/SKILL.md +++ b/skills/create-verification-skill/SKILL.md @@ -1,5 +1,6 @@ ----name: create-verification-skill -description: "Generate a project-local verification skill that drives." +--- +name: create-verification-skill +description: "Generate a project-local skill that drives the real app." version: 0.1.0 author: poteto (Hermes adaptation) license: MIT diff --git a/skills/figure-it-out/SKILL.md b/skills/figure-it-out/SKILL.md index 1284e4a..bcb63f1 100644 --- a/skills/figure-it-out/SKILL.md +++ b/skills/figure-it-out/SKILL.md @@ -1,5 +1,6 @@ ----name: figure-it-out -description: "Design an auditable playbook when no narrower one fits:." +--- +name: figure-it-out +description: "Use when no playbook fits: design an auditable one first." version: 0.1.0 author: poteto (Hermes adaptation) license: MIT diff --git a/skills/how/SKILL.md b/skills/how/SKILL.md index 7fdfa62..057a1af 100644 --- a/skills/how/SKILL.md +++ b/skills/how/SKILL.md @@ -1,5 +1,6 @@ ----name: how -description: "Explain how code works. Subsystem walkthroughs and." +--- +name: how +description: "Use to explain how code works, with walkthroughs." version: 0.1.0 author: poteto (Hermes adaptation) license: MIT diff --git a/skills/in-your-own-words/SKILL.md b/skills/in-your-own-words/SKILL.md index ba59f24..58f33a3 100644 --- a/skills/in-your-own-words/SKILL.md +++ b/skills/in-your-own-words/SKILL.md @@ -1,4 +1,5 @@ ----name: in-your-own-words +--- +name: in-your-own-words description: "Restate the user's goals and problem before work." version: 0.1.0 author: poteto (Hermes adaptation) diff --git a/skills/interrogate/SKILL.md b/skills/interrogate/SKILL.md index 4d55540..af6a413 100644 --- a/skills/interrogate/SKILL.md +++ b/skills/interrogate/SKILL.md @@ -1,5 +1,6 @@ ----name: interrogate -description: "Multi-model adversarial code review via parallel." +--- +name: interrogate +description: "Use before merging for adversarial multi-model code review." version: 0.1.0 author: poteto (Hermes adaptation) license: MIT diff --git a/skills/maintain-formal-verification-skill/SKILL.md b/skills/maintain-formal-verification-skill/SKILL.md index 40229af..778bba9 100644 --- a/skills/maintain-formal-verification-skill/SKILL.md +++ b/skills/maintain-formal-verification-skill/SKILL.md @@ -1,4 +1,5 @@ ----name: maintain-formal-verification-skill +--- +name: maintain-formal-verification-skill description: "Resync formal verification with changed code." version: 0.1.0 author: poteto (Hermes adaptation) diff --git a/skills/maintain-verification-skill/SKILL.md b/skills/maintain-verification-skill/SKILL.md index 38f36cd..e0e0314 100644 --- a/skills/maintain-verification-skill/SKILL.md +++ b/skills/maintain-verification-skill/SKILL.md @@ -1,5 +1,6 @@ ----name: maintain-verification-skill -description: "Periodic pass that keeps a project's verification skill." +--- +name: maintain-verification-skill +description: "Use to resync a project's verification skill with its app." version: 0.1.0 author: poteto (Hermes adaptation) license: MIT diff --git a/skills/no-comments/SKILL.md b/skills/no-comments/SKILL.md index f062794..df7e3dd 100644 --- a/skills/no-comments/SKILL.md +++ b/skills/no-comments/SKILL.md @@ -1,5 +1,6 @@ ----name: no-comments -description: "Spawn Comment Sicko, fix accepted findings, and offer." +--- +name: no-comments +description: "Use to remove needless code comments via Comment Sicko." version: 0.1.0 author: poteto (Hermes adaptation) license: MIT diff --git a/skills/poteto-mode/SKILL.md b/skills/poteto-mode/SKILL.md index 12cdb6c..0b564f4 100644 --- a/skills/poteto-mode/SKILL.md +++ b/skills/poteto-mode/SKILL.md @@ -1,5 +1,6 @@ ----name: poteto-mode -description: "Engineering rigor orchestrator with playbooks and." +--- +name: poteto-mode +description: "Use first on any engineering task to route to a playbook." version: 0.1.0 author: poteto (Hermes adaptation) license: MIT diff --git a/skills/principle-attack-the-premise/SKILL.md b/skills/principle-attack-the-premise/SKILL.md index 5996b60..89a07ca 100644 --- a/skills/principle-attack-the-premise/SKILL.md +++ b/skills/principle-attack-the-premise/SKILL.md @@ -1,5 +1,6 @@ ----name: principle-attack-the-premise -description: "Apply when two or more fixes that share one premise have." +--- +name: principle-attack-the-premise +description: "Apply when fixes sharing one premise keep failing a gate." version: 0.1.0 author: poteto (Hermes adaptation) license: MIT diff --git a/skills/principle-boundary-discipline/SKILL.md b/skills/principle-boundary-discipline/SKILL.md index cbf2771..a746e8e 100644 --- a/skills/principle-boundary-discipline/SKILL.md +++ b/skills/principle-boundary-discipline/SKILL.md @@ -1,5 +1,6 @@ ----name: principle-boundary-discipline -description: "Apply when wiring validation, error handling, or." +--- +name: principle-boundary-discipline +description: "Apply when placing validation or error handling in code." version: 0.1.0 author: poteto (Hermes adaptation) license: MIT diff --git a/skills/principle-build-the-lever/SKILL.md b/skills/principle-build-the-lever/SKILL.md index 82e1b86..4ad9bad 100644 --- a/skills/principle-build-the-lever/SKILL.md +++ b/skills/principle-build-the-lever/SKILL.md @@ -1,5 +1,6 @@ ----name: principle-build-the-lever -description: "Apply to any non-trivial work, not just bulk work:." +--- +name: principle-build-the-lever +description: "Apply to non-trivial work: build the tool that does it." version: 0.1.0 author: poteto (Hermes adaptation) license: MIT diff --git a/skills/principle-encode-lessons-in-structure/SKILL.md b/skills/principle-encode-lessons-in-structure/SKILL.md index 335bf26..926d649 100644 --- a/skills/principle-encode-lessons-in-structure/SKILL.md +++ b/skills/principle-encode-lessons-in-structure/SKILL.md @@ -1,5 +1,6 @@ ----name: principle-encode-lessons-in-structure -description: "Apply when you catch yourself writing the same." +--- +name: principle-encode-lessons-in-structure +description: "Apply when writing the same instruction twice: encode it." version: 0.1.0 author: poteto (Hermes adaptation) license: MIT diff --git a/skills/principle-exhaust-the-design-space/SKILL.md b/skills/principle-exhaust-the-design-space/SKILL.md index d4c350d..d471050 100644 --- a/skills/principle-exhaust-the-design-space/SKILL.md +++ b/skills/principle-exhaust-the-design-space/SKILL.md @@ -1,5 +1,6 @@ ----name: principle-exhaust-the-design-space -description: "Apply when facing a novel UI interaction or." +--- +name: principle-exhaust-the-design-space +description: "Apply when a novel UI or design has no precedent." version: 0.1.0 author: poteto (Hermes adaptation) license: MIT diff --git a/skills/principle-experience-first/SKILL.md b/skills/principle-experience-first/SKILL.md index c2dde52..a31990f 100644 --- a/skills/principle-experience-first/SKILL.md +++ b/skills/principle-experience-first/SKILL.md @@ -1,5 +1,6 @@ ----name: principle-experience-first -description: "Apply when product, UX, or feature-scope tradeoffs come." +--- +name: principle-experience-first +description: "Apply when product, UX, or scope tradeoffs come up." version: 0.1.0 author: poteto (Hermes adaptation) license: MIT diff --git a/skills/principle-explain-the-number/SKILL.md b/skills/principle-explain-the-number/SKILL.md index d3aebc9..1332f54 100644 --- a/skills/principle-explain-the-number/SKILL.md +++ b/skills/principle-explain-the-number/SKILL.md @@ -1,5 +1,6 @@ ----name: principle-explain-the-number -description: "Apply before you trust, report, or act on a number you." +--- +name: principle-explain-the-number +description: "Apply before you trust or report a measured number." version: 0.1.0 author: poteto (Hermes adaptation) license: MIT diff --git a/skills/principle-fix-root-causes/SKILL.md b/skills/principle-fix-root-causes/SKILL.md index 5e1fb6f..5c0456f 100644 --- a/skills/principle-fix-root-causes/SKILL.md +++ b/skills/principle-fix-root-causes/SKILL.md @@ -1,5 +1,6 @@ ----name: principle-fix-root-causes -description: "Apply when debugging. Trace each symptom to its root." +--- +name: principle-fix-root-causes +description: "Apply when debugging: trace each symptom to its root." version: 0.1.0 author: poteto (Hermes adaptation) license: MIT diff --git a/skills/principle-foundational-thinking/SKILL.md b/skills/principle-foundational-thinking/SKILL.md index d8cbe2f..c7f4ada 100644 --- a/skills/principle-foundational-thinking/SKILL.md +++ b/skills/principle-foundational-thinking/SKILL.md @@ -1,5 +1,6 @@ ----name: principle-foundational-thinking -description: "Apply before writing logic: choosing core types and data." +--- +name: principle-foundational-thinking +description: "Apply before writing logic: pick core types and data first." version: 0.1.0 author: poteto (Hermes adaptation) license: MIT diff --git a/skills/principle-guard-the-context-window/SKILL.md b/skills/principle-guard-the-context-window/SKILL.md index 08f688d..a7413d7 100644 --- a/skills/principle-guard-the-context-window/SKILL.md +++ b/skills/principle-guard-the-context-window/SKILL.md @@ -1,5 +1,6 @@ ----name: principle-guard-the-context-window -description: "Apply when context is filling up: large outputs, long." +--- +name: principle-guard-the-context-window +description: "Apply when context fills with large outputs or files." version: 0.1.0 author: poteto (Hermes adaptation) license: MIT diff --git a/skills/principle-laziness-protocol/SKILL.md b/skills/principle-laziness-protocol/SKILL.md index 310baa7..b397ac4 100644 --- a/skills/principle-laziness-protocol/SKILL.md +++ b/skills/principle-laziness-protocol/SKILL.md @@ -1,5 +1,6 @@ ----name: principle-laziness-protocol -description: "Apply when refactoring, evaluating diff size, or tempted." +--- +name: principle-laziness-protocol +description: "Apply when refactoring or tempted to add more code." version: 0.1.0 author: poteto (Hermes adaptation) license: MIT diff --git a/skills/principle-make-operations-idempotent/SKILL.md b/skills/principle-make-operations-idempotent/SKILL.md index cbd5fc7..aa27c22 100644 --- a/skills/principle-make-operations-idempotent/SKILL.md +++ b/skills/principle-make-operations-idempotent/SKILL.md @@ -1,5 +1,6 @@ ----name: principle-make-operations-idempotent -description: "Apply when designing commands, lifecycle steps, or." +--- +name: principle-make-operations-idempotent +description: "Apply when designing commands or steps that may rerun." version: 0.1.0 author: poteto (Hermes adaptation) license: MIT diff --git a/skills/principle-migrate-callers-then-delete-legacy-apis/SKILL.md b/skills/principle-migrate-callers-then-delete-legacy-apis/SKILL.md index 8b1f8ce..e728aa1 100644 --- a/skills/principle-migrate-callers-then-delete-legacy-apis/SKILL.md +++ b/skills/principle-migrate-callers-then-delete-legacy-apis/SKILL.md @@ -1,5 +1,6 @@ ----name: principle-migrate-callers-then-delete-legacy-apis -description: "Apply when introducing a new internal API while old." +--- +name: principle-migrate-callers-then-delete-legacy-apis +description: "Apply when replacing an internal API: migrate, then delete." version: 0.1.0 author: poteto (Hermes adaptation) license: MIT diff --git a/skills/principle-minimize-reader-load/SKILL.md b/skills/principle-minimize-reader-load/SKILL.md index 9a84ac1..38c2dba 100644 --- a/skills/principle-minimize-reader-load/SKILL.md +++ b/skills/principle-minimize-reader-load/SKILL.md @@ -1,5 +1,6 @@ ----name: principle-minimize-reader-load -description: "Apply when reviewing or shaping code that's hard to." +--- +name: principle-minimize-reader-load +description: "Apply when reviewing code that is hard to read or trace." version: 0.1.0 author: poteto (Hermes adaptation) license: MIT diff --git a/skills/principle-model-the-domain/SKILL.md b/skills/principle-model-the-domain/SKILL.md index 0580a25..79e6cd7 100644 --- a/skills/principle-model-the-domain/SKILL.md +++ b/skills/principle-model-the-domain/SKILL.md @@ -1,5 +1,6 @@ ----name: principle-model-the-domain -description: "Apply when writing stateful logic, or when code branches." +--- +name: principle-model-the-domain +description: "Apply when stateful logic branches on scattered conditions." version: 0.1.0 author: poteto (Hermes adaptation) license: MIT diff --git a/skills/principle-never-block-on-the-human/SKILL.md b/skills/principle-never-block-on-the-human/SKILL.md index bc01c46..3ee5f0d 100644 --- a/skills/principle-never-block-on-the-human/SKILL.md +++ b/skills/principle-never-block-on-the-human/SKILL.md @@ -1,5 +1,6 @@ ----name: principle-never-block-on-the-human -description: "Apply when tempted to ask 'should I do X?' on reversible." +--- +name: principle-never-block-on-the-human +description: "Apply when tempted to ask permission on reversible work." version: 0.1.0 author: poteto (Hermes adaptation) license: MIT diff --git a/skills/principle-outcome-oriented-execution/SKILL.md b/skills/principle-outcome-oriented-execution/SKILL.md index 6ec60b0..a70ce71 100644 --- a/skills/principle-outcome-oriented-execution/SKILL.md +++ b/skills/principle-outcome-oriented-execution/SKILL.md @@ -1,5 +1,6 @@ ----name: principle-outcome-oriented-execution -description: "Apply during planned rewrites and migrations with." +--- +name: principle-outcome-oriented-execution +description: "Apply during planned rewrites with explicit phase gates." version: 0.1.0 author: poteto (Hermes adaptation) license: MIT diff --git a/skills/principle-prove-it-works/SKILL.md b/skills/principle-prove-it-works/SKILL.md index 5cfe400..d91e467 100644 --- a/skills/principle-prove-it-works/SKILL.md +++ b/skills/principle-prove-it-works/SKILL.md @@ -1,5 +1,6 @@ ----name: principle-prove-it-works -description: "Apply after completing a task, before declaring done.." +--- +name: principle-prove-it-works +description: "Apply after finishing a task, before declaring it done." version: 0.1.0 author: poteto (Hermes adaptation) license: MIT diff --git a/skills/principle-redesign-from-first-principles/SKILL.md b/skills/principle-redesign-from-first-principles/SKILL.md index 8752f51..1040b30 100644 --- a/skills/principle-redesign-from-first-principles/SKILL.md +++ b/skills/principle-redesign-from-first-principles/SKILL.md @@ -1,5 +1,6 @@ ----name: principle-redesign-from-first-principles -description: "Apply when integrating a new requirement into an." +--- +name: principle-redesign-from-first-principles +description: "Apply when adding a requirement to an existing design." version: 0.1.0 author: poteto (Hermes adaptation) license: MIT diff --git a/skills/principle-separate-before-serializing-shared-state/SKILL.md b/skills/principle-separate-before-serializing-shared-state/SKILL.md index 55abefd..7774f90 100644 --- a/skills/principle-separate-before-serializing-shared-state/SKILL.md +++ b/skills/principle-separate-before-serializing-shared-state/SKILL.md @@ -1,5 +1,6 @@ ----name: principle-separate-before-serializing-shared-state -description: "Apply when concurrent actors might write to the same." +--- +name: principle-separate-before-serializing-shared-state +description: "Apply when concurrent actors may write the same state." version: 0.1.0 author: poteto (Hermes adaptation) license: MIT diff --git a/skills/principle-sequence-verifiable-units/SKILL.md b/skills/principle-sequence-verifiable-units/SKILL.md index 8e90bc3..b3030f7 100644 --- a/skills/principle-sequence-verifiable-units/SKILL.md +++ b/skills/principle-sequence-verifiable-units/SKILL.md @@ -1,5 +1,6 @@ ----name: principle-sequence-verifiable-units -description: "Apply to multi-step work (sweeps, migrations, runs of." +--- +name: principle-sequence-verifiable-units +description: "Apply to multi-step work: verify each unit before the next." version: 0.1.0 author: poteto (Hermes adaptation) license: MIT diff --git a/skills/principle-subtract-before-you-add/SKILL.md b/skills/principle-subtract-before-you-add/SKILL.md index 43d4d15..1c54593 100644 --- a/skills/principle-subtract-before-you-add/SKILL.md +++ b/skills/principle-subtract-before-you-add/SKILL.md @@ -1,5 +1,6 @@ ----name: principle-subtract-before-you-add -description: "Apply when sequencing an addition, refactor, or rewrite.." +--- +name: principle-subtract-before-you-add +description: "Apply when adding or refactoring: remove complexity first." version: 0.1.0 author: poteto (Hermes adaptation) license: MIT diff --git a/skills/principle-test-behavior-not-implementation/SKILL.md b/skills/principle-test-behavior-not-implementation/SKILL.md index 6bf55ce..1f3c305 100644 --- a/skills/principle-test-behavior-not-implementation/SKILL.md +++ b/skills/principle-test-behavior-not-implementation/SKILL.md @@ -1,5 +1,6 @@ ----name: principle-test-behavior-not-implementation -description: "Apply when you write, change, or keep a test. Call the." +--- +name: principle-test-behavior-not-implementation +description: "Apply when writing or reviewing tests: test behavior." version: 0.1.0 author: poteto (Hermes adaptation) license: MIT diff --git a/skills/principle-type-system-discipline/SKILL.md b/skills/principle-type-system-discipline/SKILL.md index ede3e7c..93964bb 100644 --- a/skills/principle-type-system-discipline/SKILL.md +++ b/skills/principle-type-system-discipline/SKILL.md @@ -1,5 +1,6 @@ ----name: principle-type-system-discipline -description: "Apply when designing types, reviewing a function." +--- +name: principle-type-system-discipline +description: "Apply when designing types or reviewing function signatures." version: 0.1.0 author: poteto (Hermes adaptation) license: MIT diff --git a/skills/recall/SKILL.md b/skills/recall/SKILL.md index c35505b..871a002 100644 --- a/skills/recall/SKILL.md +++ b/skills/recall/SKILL.md @@ -1,5 +1,6 @@ ----name: recall -description: "Reconstruct your recent working context from your own." +--- +name: recall +description: "Use before resuming work to rebuild recent context." version: 0.1.0 author: poteto (Hermes adaptation) license: MIT diff --git a/skills/reflect/SKILL.md b/skills/reflect/SKILL.md index e3274c2..c2910ee 100644 --- a/skills/reflect/SKILL.md +++ b/skills/reflect/SKILL.md @@ -1,5 +1,6 @@ ----name: reflect -description: "Spawn three parallel review subagents over the active." +--- +name: reflect +description: "Use when asked to reflect: route learnings into skills." version: 0.1.0 author: poteto (Hermes adaptation) license: MIT diff --git a/skills/setup-pstack/SKILL.md b/skills/setup-pstack/SKILL.md index d0f7ffd..1fd1cc9 100644 --- a/skills/setup-pstack/SKILL.md +++ b/skills/setup-pstack/SKILL.md @@ -1,4 +1,5 @@ ----name: setup-pstack +--- +name: setup-pstack description: "Pick the model and reasoning budget pstack delegates use." version: 0.1.0 author: poteto (Hermes adaptation) diff --git a/skills/sharpen/SKILL.md b/skills/sharpen/SKILL.md index 530399d..5069311 100644 --- a/skills/sharpen/SKILL.md +++ b/skills/sharpen/SKILL.md @@ -1,4 +1,5 @@ ----name: sharpen +--- +name: sharpen description: "Sharpen a task's framing before starting the work." version: 0.1.0 author: poteto (Hermes adaptation) diff --git a/skills/show-me-your-work/SKILL.md b/skills/show-me-your-work/SKILL.md index 569cc0c..dd3a247 100644 --- a/skills/show-me-your-work/SKILL.md +++ b/skills/show-me-your-work/SKILL.md @@ -1,5 +1,6 @@ ----name: show-me-your-work -description: "Keep a reviewable decision trail for long-running or." +--- +name: show-me-your-work +description: "Use for long-running work that needs a decision trail." version: 0.1.0 author: poteto (Hermes adaptation) license: MIT diff --git a/skills/swarm/SKILL.md b/skills/swarm/SKILL.md index af9f363..7b5ab63 100644 --- a/skills/swarm/SKILL.md +++ b/skills/swarm/SKILL.md @@ -1,4 +1,5 @@ ----name: swarm +--- +name: swarm description: "Fan out parallel workers via delegate_task, drain, report." version: 0.1.0 author: poteto (Hermes adaptation) diff --git a/skills/tdd/SKILL.md b/skills/tdd/SKILL.md index e977d7d..ea0b6a7 100644 --- a/skills/tdd/SKILL.md +++ b/skills/tdd/SKILL.md @@ -1,5 +1,6 @@ ----name: tdd -description: "Use only when the user explicitly asks for TDD, a." +--- +name: tdd +description: "Use only when the user explicitly asks for TDD." version: 0.1.0 author: poteto (Hermes adaptation) license: MIT diff --git a/skills/teach/SKILL.md b/skills/teach/SKILL.md index 5eaaa82..91a2dae 100644 --- a/skills/teach/SKILL.md +++ b/skills/teach/SKILL.md @@ -1,5 +1,6 @@ ----name: teach -description: "Explain a body of work plainly so a person actually." +--- +name: teach +description: "Use to explain a body of work plainly at the user's pace." version: 0.1.0 author: poteto (Hermes adaptation) license: MIT diff --git a/skills/technical-writing/SKILL.md b/skills/technical-writing/SKILL.md index 136fa64..cb441fb 100644 --- a/skills/technical-writing/SKILL.md +++ b/skills/technical-writing/SKILL.md @@ -1,5 +1,6 @@ ----name: technical-writing -description: "Layered technical-writing standard: Diátaxis structure,." +--- +name: technical-writing +description: "Use when writing or editing technical docs or READMEs." version: 0.1.0 author: poteto (Hermes adaptation) license: MIT diff --git a/skills/typescript-best-practices/SKILL.md b/skills/typescript-best-practices/SKILL.md index 8b40176..f9d60bc 100644 --- a/skills/typescript-best-practices/SKILL.md +++ b/skills/typescript-best-practices/SKILL.md @@ -1,5 +1,6 @@ ----name: typescript-best-practices -description: "TypeScript best practices. Use when reading or editing." +--- +name: typescript-best-practices +description: "Use when reading or editing TypeScript code." version: 0.1.0 author: poteto (Hermes adaptation) license: MIT diff --git a/skills/unslop/SKILL.md b/skills/unslop/SKILL.md index a723d2f..1b62b70 100644 --- a/skills/unslop/SKILL.md +++ b/skills/unslop/SKILL.md @@ -1,4 +1,5 @@ ----name: unslop +--- +name: unslop description: "Cut AI tells from writing. Apply to all prose surfaces." version: 0.1.0 author: poteto (Hermes adaptation) diff --git a/skills/why/SKILL.md b/skills/why/SKILL.md index 8e31b44..dcc00e6 100644 --- a/skills/why/SKILL.md +++ b/skills/why/SKILL.md @@ -1,5 +1,6 @@ ----name: why -description: "Use for 'why does X work this way', 'why we picked Y',." +--- +name: why +description: "Use for 'why does X work this way' or 'why did we pick Y'." version: 0.1.0 author: poteto (Hermes adaptation) license: MIT