write-a-skill

Create agent skills with compliant SKILL.md structure and resource bundling.

10|2|Updated Dec 29, 2025
One-click install
npx skills add https://github.com/sumpalabs/petrodb --skill write-a-skill-sumpalabs
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: write-a-skill
Source: https://github.com/sumpalabs/petrodb/tree/main/.agents/skills/write-a-skill
Command: npx skills add https://github.com/sumpalabs/petrodb --skill write-a-skill-sumpalabs

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill eliminates the common issue of creating inconsistent, poorly structured agent skills that fail to trigger correctly, load required resources, or follow best practices for maintainability and discoverability.

Core Features & Use Cases

  • Guided Requirement Gathering: Walks users through defining skill scope, use cases, and required resources to ensure alignment with needs.
  • Compliant Structure Templates: Provides pre-built formatting and organization rules to meet agent skill standards for progressive disclosure and frontmatter requirements.
  • Resource Bundling Guidance: Offers clear rules for when to add utility scripts, reference documents, or asset files to keep core skill files lightweight. Use case: For example, if you need to build a skill to automate data validation for Parquet files, this Skill guides you through defining the validation logic, structuring the SKILL.md, adding a deterministic validation script, and splitting detailed schema docs into a separate reference file.

Quick Start

Use the write-a-skill skill to build a new skill for automating monthly sales report generation from CSV export files.

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 agent skills that trigger correctly and load resources properly?

To create agent skills that trigger correctly, you need to follow compliant file structuring, YAML frontmatter, and progressive disclosure standards. This ensures skills are discoverable and fully functional within agent environments.

What is progressive disclosure in agent skill creation?

Progressive disclosure in agent skill creation is a structuring standard that keeps core skill files lightweight by splitting detailed schema docs and references into separate bundled files, ensuring efficient resource loading.

How do I structure a SKILL.md file for workflow automation?

Structuring a SKILL.md file for workflow automation requires using compliant templates that define skill scope, use cases, and required resources while meeting YAML frontmatter and resource organization standards for maintainability.

When should I bundle utility scripts into an AI workflow skill?

You should bundle utility scripts into an AI workflow skill when deterministic processing is required, keeping the core skill files lightweight while adding reference documents or asset files to support the automation logic.

Why does my custom agent skill fail to trigger or load required resources?

Custom agent skills fail to trigger or load resources due to inconsistent, poorly structured formatting that violates progressive disclosure and frontmatter standards, preventing proper discoverability in agent environments.

Can I build agent skills for any domain using guided requirement gathering?

Yes, you can build agent skills for any domain using guided requirement gathering, which walks you through defining skill scope, use cases, and required resources to ensure alignment with your specific automation needs.