skill authoring workflow

Other Community

Skill notes

Purpose

Create or update PM skills without chaos. This workflow turns rough notes, workshop content, or half-baked prompt dumps into compliant skills/<skill-name>/SKILL.md assets that actually pass validation and belong in this repo. Use it when you want to ship a new skill without "looks good to me" roulette.

Dogfood First

Use repo-native tools and standards before inventing a custom process: scripts/find-a-skill.sh scripts/add-a-skill.sh scripts/build-a-skill.sh scripts/test-a-skill.sh

Pick the Right Creation Path

Guided wizard (build-a-skill.sh): Best when you have an idea but not final prose. Content-first generator (add-a-skill.sh): Best when you already have source content. Manual edit + validate: Best for tightening an existing skill.

Definition of Done (No Exceptions)

A skill is done only when: Frontmatter is valid (name, description, intent, type) Section order is compliant Metadata limits are respected (name <= 64 chars, description <= 200 chars) Description says both what the skill does and when to use it

Facilitation Source of Truth

When running this workflow as a guided conversation, use workshop-facilitation as the interaction protocol. It defines: session heads-up + entry mode (Guided, Context dump, Best guess) one-question turns with plain-language prompts progress labels (for example, Context Qx/8 and Scoring Qx/5)

Fluxly profile Runtime and permissions are inferred by Fluxly static checks, not author declarations or runtime test results.
Domain
Other
Author-declared agents
No explicit declaration found; this is not inferred or tested compatibility
Static check
88 / 100 · heuristic scan, not runtime safety proof
Runtime evidence
Not run; no isolated runtime test evidence is currently recorded
Author / version / license
@deanpeters · no license declared
Token usage
Lean
Setup complexity
Plug-and-play
External API key
Not required
Operating systems
Unspecified (assume cross-platform)
Runtime requirements
No explicit requirements detected
Detected file/system behavior
  • Read-only
  • Write / modify
Network behavior
Local-only
Install commands
None (reference only)

Heads up: Tool permissions are not declared; actual access depends on the runtime.

Output preview skill-authoring-workflow.preview
# Anti-Pattern Example

- Broken references
- Inconsistent catalog numbers
- Confusion for contributors and users

Discussion

Powered by GitHub Discussions. Sign in with GitHub to comment, react, or subscribe.