skills.rest
SPANDigital
SPANDigitalOFFICIAL
Explore all skills by this author →
WebsiteGitHub

skill-authoring

Author and review agent skills with progressive disclosure and concise SKILL.md files.

Updated Feb 26, 2026
Search Tags:#AI development#skill authoring#progressive disclosure#skill review#code of conduct
One-click install
npx skills add https://github.com/SPANDigital/pycel2sql --skill skill-authoring-spandigital
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: skill-authoring
Source: https://github.com/SPANDigital/pycel2sql/tree/main/.claude/skills/skill-authoring
Command: npx skills add https://github.com/SPANDigital/pycel2sql --skill skill-authoring-spandigital

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill streamlines the creation and maintenance of agent skills by enforcing best practices and ensuring efficient, effective skill design.

Core Features & Use Cases

  • Authoring Best Practices: Enforces a progressive disclosure model and concise SKILL.md file structure.
  • Code of Conduct: Establishes domain-split references, scripts over prose, and third-person descriptions.
  • Skill Split Patterns: Provides guidance on when and how to split SKILL.md for better manageability.
  • Review Checklist: Offers a pre-merge checklist for quality control.

Quick Start

Run python scripts/lint_skill.py <skill-dir> to lint your new skill directory against the defined authoring rules.

Frequently Asked Questions about skill-authoring

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

FAQPage Schema
What is progressive disclosure in AI skill authoring?▼

Progressive disclosure in AI skill authoring is a design model that keeps the SKILL.md file concise while pushing detailed domain-specific references into separate splits, ensuring agents load only necessary context.

How do I create and review agent skills efficiently?▼

You create and review agent skills efficiently by following a structured authoring process that enforces a code of conduct, uses scripts over prose, and applies a pre-merge review checklist for quality control.

When should I split SKILL.md files for better manageability?▼

You should split SKILL.md files when domain-specific references grow too large, following skill split patterns that separate concerns and keep the main file concise for better manageability.

Can I lint my AI skill directory against authoring best practices?▼

Yes, you can lint your AI skill directory by running the provided Python lint script, which checks your structured skill files against defined authoring rules and code of conduct.

What are the limitations of using prose instead of scripts in skill development?▼

Using prose instead of scripts in skill development limits execution efficiency and clarity, as the authoring code of conduct explicitly favors scripts over prose to ensure structured, reliable agent behavior.

Related Skills

Explore More Software Engineering Skills→
yellow-seedyellow-seed
2

sync-codex

Port Dockerfile RUN and ENV steps into portable shell scripts for Codex environments.

Community
Advanced
rodrigobranasrodrigobranas
1

skill-best-practices

Validate agent skill metadata against the agentskills.io specification.

Community
Intermediate
richardwoodingrichardwooding
5

skill-authoring

Create standardized agent skills with SKILL.md files and progressive disclosure.

Community
Advanced
baphledbaphled
1

static-analysis

Guide static code analysis tools to detect bugs, vulnerabilities, and style violations.

Community
Intermediate