skills.rest
pproenca
pproencaCOMMUNITY
Explore all skills by this author →
𝕏@ThePedroProencaGitHub

skill-authoring

Guide AI agent skill design with metadata, structure, and trigger best practices.

193|17|Updated Jan 16, 2026
Search Tags:#skill development#prompt engineering#AI agent#metadata#skill authoring#trigger optimization
One-click install
npx skills add https://github.com/pproenca/dot-skills --skill skill-authoring-pproenca
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: skill-authoring
Source: https://github.com/pproenca/dot-skills/tree/main/skills/.curated/skill-authoring
Command: npx skills add https://github.com/pproenca/dot-skills --skill skill-authoring-pproenca

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill provides a comprehensive guide to designing and developing effective AI agent skills, ensuring they are discoverable, reliable, and efficient.

Core Features & Use Cases

  • Skill Metadata Design: Best practices for naming, descriptions, and frontmatter.
  • Content Structure: Guidelines for organizing SKILL.md and reference files.
  • Trigger Optimization: Strategies to ensure skills activate reliably.
  • Use Case: You're building a new AI skill for your team. Use this guide to ensure your SKILL.md is well-structured, your description accurately reflects its capabilities, and it has clear triggers to be discovered by the AI.

Quick Start

Follow the best practices in this skill to design and write a new SKILL.md file.

Frequently Asked Questions about skill-authoring

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

FAQPage Schema
How do I structure a SKILL.md file for AI agent discoverability?▼

Structure SKILL.md files by applying metadata best practices, organizing content with clear descriptions, and optimizing triggers to ensure reliable activation and token efficiency for AI agent skills.

What is trigger optimization in AI skill development?▼

Trigger optimization ensures AI agent skills activate reliably by refining metadata and description engineering, directly addressing the discoverability and activation reliability needed for effective AI skill development.

How do I write effective metadata for Claude Code skills and MCP tools?▼

Write effective metadata for Claude Code skills and MCP tools by following best practices for naming, descriptions, and frontmatter to maximize discoverability and activation reliability for AI agent capabilities.

What is the best way to ensure token efficiency when authoring AI agent skills?▼

Ensure token efficiency by applying progressive disclosure and content structure guidelines in SKILL.md, organizing reference files so AI agents load only necessary capability data.

Does this skill guide cover testing and maintenance for AI agent capabilities?▼

The skill guide covers testing and maintenance for AI agent capabilities, providing best practices to sustain discoverability, activation reliability, and token efficiency throughout the skill lifecycle.

How does progressive disclosure work when designing MCP tools and Claude skills?▼

Progressive disclosure structures SKILL.md and reference files to reveal AI agent capabilities sequentially, optimizing token efficiency while maintaining comprehensive tool design and content organization.

Related Skills

Explore More Software Engineering Skills→
ductrung-nguyenductrung-nguyen

expert-agent-writer

Guide users through authoring declarative agents in .agent.md files.

Community
Intermediate
thrillmadethrillmade
1

skill-frontmatter-quality

Review SKILL.md frontmatter for triggers, descriptions, and voice consistency.

Official
Advanced
sylin-orgsylin-org
4

koan-mcp-integration

Expose Koan entities as MCP tools for Claude Code Mode.

Official
Advanced
zero-rehqzero-rehq

prompt-master

Orchestrate prompt engineering and routing skills to automate task briefs and workflows.

Community
Advanced