skill-authoring-workflow

Transform raw PM content into validated SKILL.md files with frontmatter and section-order checks.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This workflow eliminates chaotic, ad-hoc skill authoring by turning raw product-management notes, workshop outputs, or partial prompt dumps into validated, repo-compliant SKILL.md assets that pass automated checks and fit the repository structure.

Core Features & Use Cases

  • Guided creation paths: Choose between a guided wizard, content-first generator, or manual edit plus validation based on your starting material.
  • Strict validation and guardrails: Enforces frontmatter rules, section ordering, metadata limits, and trigger/intent quality to prevent broken or noncompliant skills.
  • Integration and packaging: Runs repository scripts to find duplicates, validate metadata and triggers, update README catalogs, and optionally package skills for upload.
  • Use Case: Convert workshop notes into a new interactive advisor skill, validate it against repo rules, update the README catalog, and produce a zip for Claude upload.

Quick Start

Use the workflow to generate and validate a new skill from your draft notes and run the repo validation scripts before committing.

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 PM notes into a validated SKILL.md file?

To turn rough notes into a SKILL.md file, use a guided wizard or content-first generator to transform raw PM content, enforce frontmatter rules, and produce repo-compliant assets. This ensures your skill passes automated structural checks before committing.

What is the best way to validate skill metadata before committing to a repository?

Validating skill metadata requires running repository scripts that enforce frontmatter rules, section ordering, and trigger quality. This validation process prevents broken skills by checking structural compliance and finding duplicates before you commit updates.

Can I update the README catalog automatically when adding new skills?

You can update the README catalog automatically by running repository integration scripts during your skill authoring workflow. This packaging step validates metadata, updates the catalog, and optionally produces a zip file ready for Claude upload.

Does this skill authoring workflow support workshop synthesis outputs?

Yes, the skill authoring workflow supports workshop synthesis by converting workshop outputs and partial prompt dumps into interactive advisor skills. It applies strict validation guardrails to ensure the generated content fits the repository structure.

What are the limitations of manual skill editing without structural validation?

Manual skill editing without validation risks noncompliant assets, broken triggers, and incorrect metadata limits. Bypassing repository scripts leads to structural errors and duplicate entries, preventing successful README integration and automated checks.

How do I package skills for Claude upload after authoring?

To package skills for Claude upload, run the repository validation scripts to check metadata and triggers, update the README catalog, and generate a compliant zip file. This ensures your authored skill is structurally sound and ready for deployment.