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.