Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 

Repository files navigation

skill-build-advisor

A gate skill that runs before Anthropic's skill-creator. It enforces the build discipline taught in Module 2's "Skilful Skill Creation" lesson: no skill gets drafted until the workflow has been run manually at least once, every piece of proposed content is sorted into generic-knowledge (cut) vs. proprietary-opinion (keep), branches are routed to references/ instead of flattened, and deterministic steps are flagged for scripts/ instead of left to the model.

Why this exists separately from skill-creator

skill-creator is excellent at the mechanics: YAML frontmatter, drafting, test cases, eval loops, packaging. What it doesn't do is stop someone from feeding it a premature or bloated brief in the first place. This skill is that filter. It produces a clean, scoped, opinion-only brief — then hands off.

Usage

Trigger with: "let's make this a skill," "should this be a skill," "turn this into a skill," or anytime mid-workflow when skill-worthiness is in question.

Flow:

  1. Confirms a successful manual run exists (2-3x, consistent) — refuses to proceed otherwise
  2. Triages every piece of content: generic (cut) vs. opinionated (keep)
  3. Checks for branches → routes to references/; checks for deterministic steps → routes to scripts/
  4. Right-sizes: one skill, one job, ~500 line ceiling on the opinion content
  5. Hands off the clean brief to skill-creator for actual authoring

Files

  • SKILL.md — the full gate logic and step-by-step flow
  • references/source-script-full.md — the source script this skill was derived from
  • references/usage-examples-compressed.md — compressed usage examples

About

Pre-skill-creator gate skill enforcing build discipline: validates manual runs, triages generic vs. opinionated content, routes branches to references/ and deterministic steps to scripts/ before handoff

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors