skill-authoring-workflow

Convert rough notes into compliant SKILL.md manifests with validation checks.

1|1|Updated Mar 29, 2026
One-click install
npx skills add https://github.com/yuyuxinli/moodcoco --skill skill-authoring-workflow-yuyuxinli
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-authoring-workflow
Source: https://github.com/yuyuxinli/moodcoco/tree/main/.claude/skills/skill-authoring-workflow
Command: npx skills add https://github.com/yuyuxinli/moodcoco --skill skill-authoring-workflow-yuyuxinli

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This workflow helps teams convert rough notes, workshop outputs, or half-baked prompts into a compliant, publish-ready skill manifest (SKILL.md) that fits the repo's standards and validation rules.

Core Features & Use Cases

  • Guided wizard to draft new skills from notes and rough content.
  • Content-first generator that transforms notes into a compliant SKILL.md.
  • Manual edit + validate step to tighten standards and ensure metadata integrity.
  • Preflight checks to detect duplicates, validate type, and verify cross-references.
  • Phase-driven process (Preflight → Generate Draft → Tighten → Validate → Integrate → Package) for end-to-end consistency.

Quick Start

Run the guided wizard to draft and validate a new skill from workshop notes.

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 rough notes into a publish-ready SKILL.md file?

To turn rough notes into a publish-ready SKILL.md file, use a guided wizard to generate a compliant draft, then apply manual edits and preflight validation to ensure metadata integrity. This workflow handles drafting, tightening, and integration for repository standards.

What frontmatter validation is required for skill authoring?

Frontmatter validation for skill authoring requires verifying the presence and correctness of name, description, intent, and type fields. This ensures the SKILL.md manifest meets repository compliance rules before integration.

How do I check for duplicate skills and cross-reference errors before publishing?

To check for duplicate skills and cross-reference errors, run preflight checks during the skill authoring workflow. This validation phase detects duplicates, verifies the skill type, and ensures all cross-references are accurate before packaging.

Can I update existing repository skills from workshop outputs?

Yes, you can update existing repository skills from workshop outputs by applying this workflow to both creating and updating tasks. It transforms workshop outputs and draft prompts into compliant manifests while updating the README catalog.

What is the correct section order for a compliant skill manifest?

A compliant skill manifest requires a specific section order compliance evaluated during the validation phase. The phase-driven process ensures end-to-end consistency by checking section sequencing, metadata integrity, and cross-references before final integration.