skill-authoring-workflow

Transform PM content into validated skill entries with metadata checks.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/nv-minh/superpower-agent --skill skill-authoring-workflow-nv-minh
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-authoring-workflow
Source: https://github.com/nv-minh/superpower-agent/tree/main/templates/base/Product-Manager-Skills/skills/skill-authoring-workflow
Command: npx skills add https://github.com/nv-minh/superpower-agent --skill skill-authoring-workflow-nv-minh

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This workflow prevents chaotic skill submissions by guiding PMs through standards, metadata, and validation steps so each new or updated skill is compliant and auditable.

Core Features & Use Cases

  • Dogfood-first process that uses repo-native scripts to find, build, add, and test skills.
  • Structured phases covering preflight research, draft generation, tightening, validation, documentation updates, and optional packaging for upload.
  • Use case: Turn workshop notes into a validated skill entry under skills/skill-name/SKILL.md, run metadata checks, and update README catalogs before merging.

Quick Start

Ask the workflow to turn workshop notes or loose requirements into a validated skill entry and confirm the metadata checks before commit.

Frequently Asked Questions about skill-authoring-workflow

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

FAQPage Schema
How do I validate PM skill metadata before committing to a repository?

To validate PM skill metadata before committing, use a workflow that enforces metadata validation, test scripts, and README catalog updates. This ensures each skill entry is compliant and auditable prior to repository integration.

What is the best way to turn messy workshop notes into a compliant skill entry?

The best way to turn messy workshop notes into a compliant skill entry is through a structured workflow covering draft generation, tightening, and validation. This transforms loose requirements into a repo-ready SKILL.md file.

How do I update README catalogs when adding a new PM skill?

To update README catalogs when adding a new PM skill, apply a skill-authoring workflow that includes documentation updates as a standard phase. This synchronizes the catalog before merging the new skill entry.

Do I need to run test scripts manually when creating a new skill entry?

You do not need to run test scripts manually when using a dogfood-first skill creation workflow. The process automatically applies repo-native scripts to build, add, and test skills to enforce compliance before commits.

What steps are required to package a validated skill for upload?

Packaging a validated skill for upload requires completing preflight research, draft generation, metadata validation, and documentation updates. Optional packaging is the final phase after standard compliance checks pass.