skill-writer

Guide authors through creating compliant Agent Skill definitions with SKILL.md and frontmatter.

Updated Apr 10, 2026
One-click install
npx skills add https://github.com/LuizEduPP/skills --skill skill-writer-luizedupp
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-writer
Source: https://github.com/LuizEduPP/skills/tree/main/skill-writer
Command: npx skills add https://github.com/LuizEduPP/skills --skill skill-writer-luizedupp

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill clears the confusion around why custom Skill definitions fail to activate by walking authors through every structural, naming, and discovery requirement so metadata is precise and actionable.

Core Features & Use Cases

  • Scope planning: Ask clarifying questions, keep the Skill focused on a single capability, and decide whether it belongs in a personal or project folder.
  • Structure and frontmatter: Create the directory and files, enforce lowercase hyphenated names, and write rich descriptions mentioning triggers, file types, and contexts.
  • Validation workflow: Provide checklists for YAML syntax, instructions quality, examples, optional references, and testing steps to make sure the Skill is production-ready before activation.
  • Use case: When a teammate needs a new automation, use this Skill to translate their request into a SKILL.md entry with supporting files, scripts, and documentation.

Quick Start

Guide me through defining a new Skill by specifying its trigger, frontmatter, and instructions.

Frequently Asked Questions about skill-writer

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

FAQPage Schema
Why does my custom AI skill fail to activate when triggered?

Custom AI skills fail to activate due to incorrect SKILL.md structure, invalid frontmatter syntax, or poor description quality. This Skill validates metadata, enforces lowercase hyphenated names, and checks directory structures to ensure precise discovery and activation by AI assistants.

How do I create a compliant SKILL.md file for an AI assistant?

To create a compliant SKILL.md file, draft frontmatter with validated name, description, and optional allowed-tools fields. This Skill guides you through writing clear instructions, structuring directories, and adding testing steps to ensure production readiness.

What should be included in skill frontmatter metadata for AI agents?

Skill frontmatter metadata must include a validated name, a rich description mentioning triggers and contexts, optional allowed-tools, and instructions. This Skill enforces YAML syntax validation and structural checklists to ensure AI agents can accurately parse and activate the definition.

Do I need to put my new AI skill in a personal or project folder?

You should place your new AI skill in a personal or project folder based on its intended scope. This Skill helps decide the correct placement by asking clarifying questions, keeping the capability focused, and ensuring the directory structure matches the deployment target.

What is the best way to validate YAML frontmatter and skill structure before deployment?

The best way to validate YAML frontmatter is running a structured validation workflow covering syntax, instruction quality, and examples. This Skill provides checklists for testing steps and optional references to make sure the definition is production-ready before activation.

How does skill validation handle scope and directory structure for AI automation?

Skill validation handles scope by asking clarifying questions to keep the capability focused on a single task. It then enforces correct directory and file creation, ensuring the SKILL.md entry and supporting scripts align with structural requirements for AI automation.