skills-best-practices

Create, review, and refine SKILL.md files with structured best practices.

Updated Apr 2, 2026

Search Tags:#workflow #templates #validation #best-practices #agent-skills #skill-building

Ready to run

npx skills add https://github.com/lucasgaldinos/my-skills --skill skills-best-practices

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: skills-best-practices
Source: https://github.com/lucasgaldinos/my-skills/tree/main/skills/skills-best-practices
Command: npx skills add https://github.com/lucasgaldinos/my-skills --skill skills-best-practices

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill provides a repeatable, best-practice-driven methodology for creating, reviewing, and refining Agent Skills (SKILL.md), ensuring consistent triggers, proper frontmatter, and robust workflows.

Core Features & Use Cases

Structured discovery: interview the user, classify the skill type, perform domain research, draft SKILL.md using the appropriate templates, and iterate with user feedback.
Description optimization: validate and tune the frontmatter so the Skill triggers reliably across prompts.
Progressive disclosure: bundle references, templates, and assets to load on demand, keeping SKILL.md concise.

Quick Start

Begin by interviewing the user, classify the skill type, draft SKILL.md with the appropriate template, and iterate with feedback until the description triggers reliably.

Frequently Asked Questions about skills-best-practices

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

FAQPage Schema

What are best practices for writing SKILL.md descriptions so they trigger reliably?▼

Best practices for SKILL.md descriptions involve validating and tuning frontmatter constraints to ensure consistent triggers. You should apply structured discovery, classify the skill type, and iterate with user feedback until the description activates reliably across various prompts.

How do I structure an Agent Skill workflow using templates?▼

To structure an Agent Skill workflow, start by interviewing the user to classify the skill type. Then draft the SKILL.md using official templates, apply progressive disclosure to bundle references on demand, and iterate with feedback to refine the workflow.

What is progressive disclosure in skill building and when should I use it?▼

Progressive disclosure in skill building is the practice of bundling references, templates, and assets to load on demand rather than embedding everything in the main file. Use it to keep SKILL.md concise while retaining robust workflow support.

Can I use this structured discovery process to review and refine existing Agent Skills?▼

Yes, the structured discovery process supports creating, reviewing, and refining existing Agent Skills. It enforces frontmatter constraints and references official templates to validate and tune your SKILL.md files across different domains and tools.

What's the best way to validate frontmatter constraints for Agent Skills?▼

The best way to validate frontmatter constraints is through a repeatable review process that checks triggers and references official templates. Description optimization ensures the frontmatter aligns with best practices and triggers reliably across prompts.

Why does my Agent Skill fail to trigger consistently across different prompts?▼

Agent Skills fail to trigger consistently when frontmatter is not properly validated or tuned. You need to apply description optimization best practices, iterate with user feedback, and enforce frontmatter constraints to ensure reliable activation across various prompts.