skills.rest
JuanDiego30
JuanDiego30COMMUNITY
Explore all skills by this author →
GitHub

authoring-skills

Standardize agent skill authoring with SKILL.md frontmatter and file structure.

Updated Apr 14, 2026
Search Tags:#documentation#skills#authoring#agents.md#naming-conventions#frontmatter#skill-structure
One-click install
npx skills add https://github.com/JuanDiego30/cermont_aplicativo --skill authoring-skills-juandiego30
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: authoring-skills
Source: https://github.com/JuanDiego30/cermont_aplicativo/tree/main/.agents/skills/authoring-skills
Command: npx skills add https://github.com/JuanDiego30/cermont_aplicativo --skill authoring-skills-juandiego30

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Guides users to create and maintain agent skills in .agents/skills, including frontmatter conventions, file structure, and the relationship to AGENTS.md.

Core Features & Use Cases

  • Defines supported frontmatter fields (name, description, etc.), file structure under .agents/skills (SKILL.md, workflow.md, examples.md), and naming conventions.
  • Explains how to write actionable, self-contained content and how to reference skills from AGENTS.md.

Quick Start

Create and populate a new SKILL.md under .agents/skills/ with the required frontmatter and content per this guide.

Frequently Asked Questions about authoring-skills

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

FAQPage Schema
What are the required frontmatter fields for a SKILL.md file?▼

Required frontmatter for a SKILL.md file includes name and description fields, which standardize agent skill definitions and enable auto-approval rules for autonomous execution.

How do I structure an agent skill under .agents/skills?▼

To structure an agent skill under .agents/skills, create a SKILL.md file with required frontmatter and optionally add workflow.md and examples.md files to provide detailed execution steps and usage scenarios.

What naming conventions should I follow when authoring agent skills?▼

When authoring agent skills, follow naming conventions that standardize SKILL.md file creation and directory organization under .agents/skills to ensure proper referencing from AGENTS.md.

Can I add optional sections like workflow.md and examples.md to an agent skill?▼

Yes, you can add optional sections like workflow.md and examples.md to an agent skill alongside the required SKILL.md file to document detailed workflows and provide actionable, self-contained examples.

How do I reference agent skills from AGENTS.md?▼

You reference agent skills from AGENTS.md by writing actionable, self-contained content in SKILL.md files under .agents/skills and linking them according to the established naming conventions and frontmatter structure.

What are auto-approval rules for autonomous execution in agent skills?▼

Auto-approval rules for autonomous execution are documented within the agent skill authoring process to define conditions where agents can run skills automatically without manual intervention.

Related Skills

Explore More Software Engineering Skills→
damadorPLdamadorPL
3

codex-setup

Synchronize BDOS skills into `.agents/skills/` and manage `AGENTS.md` configuration files.

Community
Intermediate
jayhjenkinsjayhjenkins
1

meeting-schema-validation

Validate meeting transcripts against a YAML frontmatter schema.

Community
Basic
UniquecreteUniquecrete

skill-creator

Create Claude skill packages with SKILL.md structure and YAML frontmatter.

Community
Intermediate
madeinoz67madeinoz67

skill-developer

Create and manage Claude Code skills with SKILL.md and skill-rules.json.

Community
Advanced