skill-authoring-workflow

Transform raw workshop notes into validated SKILL.md artifacts with repo scripts.

Updated Apr 6, 2026
One-click install
npx skills add https://github.com/sicktastic/skill-issue --skill skill-authoring-workflow-sicktastic
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: skill-authoring-workflow
Source: https://github.com/sicktastic/skill-issue/tree/main/product-management/skill-authoring-workflow
Command: npx skills add https://github.com/sicktastic/skill-issue --skill skill-authoring-workflow-sicktastic

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This workflow removes chaos when turning PM content into repo-compliant skills by enforcing consistent metadata, section order, and documentation updates so teams avoid repo breakage.

Core Features & Use Cases

  • Preflight checks: Search for overlapping skills and decide the right artifact type to avoid duplication.
  • Draft and validation phases: Run scripts/add-a-skill.sh or scripts/build-a-skill.sh, then refine intent, examples, and anti-patterns before executing test-a-skill and metadata/trigger validators.
  • Integration and packaging: Update README tables and counts, resolve references, and optionally zip assets for Claude uploads while adhering to the workshop-facilitation protocol.

Quick Start

Run scripts/build-a-skill.sh or scripts/add-a-skill.sh on your raw notes and complete the Phase 3-5 validation and README updates before committing the new skill.

Frequently Asked Questions about skill-authoring-workflow

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I turn workshop notes into compliant SKILL.md artifacts?▼

To turn workshop notes into compliant SKILL.md artifacts, run scripts/build-a-skill.sh or scripts/add-a-skill.sh on raw drafts, then complete Phase 3-5 validation and README updates before committing the new skill.

What is the best way to validate skill metadata and triggers before committing?▼

The best way to validate skill metadata and triggers is executing built-in validators during Phase 3-5, running test-a-skill checks, and enforcing schema rules to prevent repo breakage before final integration.

How does preflight checking prevent duplicate skills in a repository?▼

Preflight checking prevents duplicate skills by searching for overlapping skills in the repository, allowing contributors to decide the right artifact type and avoid duplication before drafting begins.

Can I package skill assets into zip files for Claude uploads?▼

Yes, you can package skill assets into zip files for Claude uploads during the integration and packaging phase, optionally zipping assets while adhering to workshop-facilitation protocols.

Why does updating README tables matter when adding a new skill?▼

Updating README tables matters when adding a new skill because it resolves references, updates counts, and maintains catalog integration, preventing repo breakage caused by inconsistent documentation.

When do I need definition-of-done checks for PM skill authoring?▼

You need definition-of-done checks for PM skill authoring whenever maintaining or shipping skills, ensuring structured validation, section order compliance, and metadata schema rules are fully met.