write-a-skill

Name: write-a-skill
Availability: InStock
Author: mrwillist

Creates agent skills with SKILL.md structure, progressive disclosure, and bundled resources for reuse.

7|2|Updated Apr 30, 2026

Search Tags:#templates #documentation #skill authoring #YAML frontmatter #agent workflows #deterministic scripts #reusable resources

Ready to run

npx skills add https://github.com/MRWillisT/PullNexus --skill write-a-skill-mrwillist

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: write-a-skill
Source: https://github.com/MRWillisT/PullNexus/tree/main/skills/write-a-skill
Command: npx skills add https://github.com/MRWillisT/PullNexus --skill write-a-skill-mrwillist

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill streamlines how users create new agent skills by providing a consistent structure and clear, progressive steps for drafting the right instructions and supporting materials.

Core Features & Use Cases

Guided requirements gathering: Helps collect the target task/domain, required use cases, whether deterministic scripts are needed, and what reference materials should be included.
Structured skill authoring: Produces a ready-to-use SKILL.md with an actionable workflow section and an optional advanced section that links to supporting files.
Smarter skill packaging: Encourages adding reference docs and utility scripts only when they add reliability or depth, improving discovery and reusability.

Quick Start

Use it when you want to create a new agent skill, and tell the AI what task the skill should cover and which inputs or scripts (if any) the skill should include.

Frequently Asked Questions about write-a-skill

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

FAQPage Schema

How do I create a new agent skill with a consistent structure?▼

To author an agent skill, you need a SKILL.md file with YAML frontmatter defining the name and description, followed by operational instruction text and optional bundled resources for reuse. This skill guides you through that entire creation process.

What is progressive disclosure in skill authoring?▼

Progressive disclosure in skill authoring structures a SKILL.md with an actionable workflow section and an optional advanced section linking to supporting files, keeping core instructions concise while providing deeper reference materials on demand.

How do I package deterministic scripts into a reusable agent skill?▼

You package deterministic scripts into an agent skill by bundling them as utility resources alongside your SKILL.md, adding them only when they improve reliability or depth for the specific agent workflow you are targeting.

Do I need YAML frontmatter to make an agent skill discoverable?▼

Yes, YAML frontmatter is required for skill discovery. You must define the skill's name and description in the YAML frontmatter at the top of the SKILL.md file to satisfy discovery requirements and ensure proper indexing.

What's the best way to structure reference documentation for agent workflows?▼

The best way to structure reference documentation is to bundle it as supporting files linked from an advanced section in your SKILL.md, encouraging the addition of reference docs only when they add reliability or depth to the workflow.

Can I use this skill to author workflows without any supporting scripts?▼

Yes, you can author workflows without scripts. The guided requirements gathering helps you decide whether deterministic scripts are needed, and the resulting SKILL.md can function with instruction text alone if scripts do not add reliability.