skill-authoring-workflow

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

Updated Mar 25, 2026
One-click install
npx skills add https://github.com/EchoNoReturn/task-manager --skill skill-authoring-workflow-echonoreturn
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-authoring-workflow
Source: https://github.com/EchoNoReturn/task-manager/tree/main/.agents/skills/skill-authoring-workflow
Command: npx skills add https://github.com/EchoNoReturn/task-manager --skill skill-authoring-workflow-echonoreturn

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Turn rough notes into a compliant, publish-ready skill manifest that adheres to repository standards, reducing chaos and manual rework.

Core Features & Use Cases

  • Dogfood First: Use repo-native tools and standards before inventing a custom process.
  • Pick the Right Creation Path: Guided wizard (build-a-skill), Content-first generator (add-a-skill), and Manual edit + validate.
  • Definition of Done: A skill is complete when frontmatter is valid (name, description, intent, type), section order is compliant, metadata limits are respected, and cross-references resolve.

Quick Start

Run the guided wizard or content-first scripts to create and validate a new SKILL.md 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 compliant skill manifest?

You can turn rough PM notes into a compliant skill manifest by running a guided wizard or content-first generator that drafts, validates, and integrates frontmatter and sections before committing.

What validation checks are required for skill frontmatter and repository standards?

Skill frontmatter validation requires checking name, description, intent, and type fields, while repository standards enforce compliant section order, metadata limits, and resolving cross-references.

What is the best way to create a new repository skill without manual rework?

The best way to create a new repository skill is using repo-native authoring tools like the build-a-skill wizard or add-a-skill generator to draft and validate content automatically.

Can I update an existing skill manifest using a content-first workflow?

Yes, you can update an existing skill manifest using a content-first workflow that applies preflight checks, drafts updates, and validates frontmatter and cross-references before integration.

When do I need to run preflight and validation steps for skill authoring?

You need to run preflight and validation steps for skill authoring whenever creating new repo skills or updating existing ones to ensure frontmatter is valid and cross-references resolve.

Why does my skill manifest fail repository standards during manual edits?

A skill manifest fails repository standards during manual edits when frontmetadata limits are exceeded, section order is non-compliant, or cross-reference checks fail to resolve properly.