skill-author

Generates standards-compliant SKILL.md files from natural-language capability descriptions.

2.0k|291|Updated Jul 24, 2026
One-click install
npx skills add https://github.com/Pinvou/pinvou-agent --skill skill-author-pinvou
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-author
Source: https://github.com/Pinvou/pinvou-agent/tree/main/pinvou3-app/src-tauri/resources/common/skill-marketplace/skill-author
Command: npx skills add https://github.com/Pinvou/pinvou-agent --skill skill-author-pinvou

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Turning a rough idea for an AI agent capability into a properly structured Skill requires knowing the SKILL.md format, frontmatter rules, and naming conventions. This Skill guides the creation of a valid SKILL.md from a plain-language description, so the result passes import validation and triggers correctly. ## Core Features & Use Cases - Guided Requirements Gathering: Asks clarifying questions about what the skill does, when it should trigger, bundled assets, and naming before writing anything. - SKILL.md Generation: Produces frontmatter with a valid name (kebab-case, [a-zA-Z0-9_-]{1,64}) and a description that states what the skill does and when to use it, plus a body with goals, steps, red lines, and examples. - Optional Plugin Packaging: When a distributable package is needed, it follows the plugin-package standard to add plugin.json, an icon.svg, and export a directory or zip ready for upload. - Use Case: A user says "help me create a skill that summarizes meeting notes." The Skill asks about triggers and materials, then writes skills/meeting-notes-summary/SKILL.md and asks whether to install it. ## Quick Start Ask the agent to create a new skill that does the task you describe, and answer its questions about purpose, triggers, and naming.

Frequently Asked Questions about skill-author

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

FAQPage Schema
How do I create a new SKILL.md for an AI agent?

Describe the capability you want in one sentence, then answer questions about what the skill does, when it should trigger, and any bundled scripts or references. The Skill writes a SKILL.md with valid frontmatter and executable instructions under skills/<name>/.

What are the naming rules for a skill name in SKILL.md?

The name must match [a-zA-Z0-9_-]{1,64} and should be lowercase kebab-case like git-commit-helper. Dots, path separators, and spaces are forbidden, and names like "." or ".." are rejected by import validation.

What must the description field in SKILL.md contain?

The description must state what the skill does and when it should be used, since it is the basis the model uses to trigger the skill. Vague text like "a useful skill" is not acceptable.

Can I package a skill as an installable plugin?

Yes. When you need an uploadable package, the Skill follows the plugin-package standard: it adds a plugin.json with manifest_version 1 and a components.skills entry, generates a simple icon.svg, and exports a directory or zip whose root is plugin.json.

When should I not use this skill-authoring workflow?

Do not use it when you already have a skill file and only need packaging or standardization, when you just want a plain script or webpage rather than a skill, or when you want to install, remove, or toggle an existing tool.

Does the Skill install the generated skill automatically?

No. After generating or exporting the skill, it asks whether you want to install it and waits for confirmation. Installation is done by uploading the zip in the plugin center or installing from the store's skills section.