skill-authoring

Create reusable SKILL.md instruction files that extend agent capabilities across sessions.

Updated Apr 20, 2026
One-click install
npx skills add https://github.com/AmirEmad11/instabot --skill skill-authoring-amiremad11
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-authoring
Source: https://github.com/AmirEmad11/instabot/tree/main/.local/skills/skill-authoring
Command: npx skills add https://github.com/AmirEmad11/instabot --skill skill-authoring-amiremad11

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Repeatedly re-explaining the same workflows to an AI agent wastes time and produces inconsistent results. This Skill provides a structured process for capturing reusable knowledge, procedures, and workflows as persistent skill files that future agent sessions can discover and follow. ## Core Features & Use Cases - Skill File Creation: Guides the creation of SKILL.md files with proper YAML frontmatter (name and description) and instruction bodies written to .agents/skills/SKILLNAME/. - Discovery Optimization: Explains how to write descriptions that trigger the skill at the right time, with concrete good and bad examples. - Authoring Best Practices: Covers naming rules, length limits, when to split content into reference files, and how skills can reference or update other skills. - Use Case: A user repeatedly asks the agent to review pull requests in a specific way. Use this Skill to create a pr-review skill that encodes the review checklist and output format once, so every future PR review follows the same process. ## Quick Start Create a skill that teaches you how to review pull requests using our team's checklist and save it for future sessions.

Frequently Asked Questions about skill-authoring

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

FAQPage Schema
How do I create a reusable skill for an AI agent?

Write a SKILL.md file with YAML frontmatter containing a name and description, followed by Markdown instructions, and save it to .agents/skills/SKILLNAME/SKILL.md. The description determines when the agent will discover and use the skill.

What should a skill description include for discovery?

A skill description should state what the skill does and when to use it, in under 1024 characters. Vague descriptions like 'Processes documents' fail to trigger; specific ones like 'Extracts text from PDF files. Use when the user asks to parse PDFs' work reliably.

What are the naming rules for SKILL.md frontmatter?

The name field allows a maximum of 64 characters using only lowercase letters, numbers, and hyphens, such as code-review or pr-review. The description field allows up to 1024 characters.

Can I update a skill after creating it?

Skills stored in .agents/skills/ are fully mutable and can be edited or deleted as needs evolve. Skills in ~/.local/skills/ are platform-managed and read-only, so they cannot be modified.

How do I handle skills with large amounts of content?

Keep SKILL.md under 500 lines and move lengthy material into separate reference files, such as .agents/skills/SKILLNAME/reference/api.md. Link to those files from the main SKILL.md body so they load only when needed.