authoring-agent-skills

Guide authors in creating clear, maintainable agent skills for Claude.

1|Updated Feb 20, 2026
One-click install
npx skills add https://github.com/MrHadiSatrio/Skills --skill authoring-agent-skills-mrhadisatrio
Or copy as Structured Prompt for Agentโ–ผ
Please help me install this Agent Skill.
Skill: authoring-agent-skills
Source: https://github.com/MrHadiSatrio/Skills/tree/main/authoring-agent-skills
Command: npx skills add https://github.com/MrHadiSatrio/Skills --skill authoring-agent-skills-mrhadisatrio

SYSTEM DOCUMENTATION & REQUIREMENTS

๐Ÿ’ก This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill unit provides guidelines for authors to create clear, effective, and maintainable agent skills.

Core Features & Use Cases

  • Weakest-Reader Principle: Ensures that the skill is understandable by an agent with limited reasoning capacity.
  • Naming and Frontmatter: Guidelines on how to structure skill names and frontmatter for clarity and discoverability.
  • Structure: A recommended structure for SKILL.md files to ensure a consistent and clear presentation of instructions.
  • Examples: How to write and include examples that are clear and informative.
  • References and Paths: Best practices for referencing external content and internal components.
  • Runtime Robustness: Ensures the skill works reliably in both Claude Code and the Anthropic Skills API.
  • Deployment: Guidelines for deploying skills to the Anthropic Skills API.

Quick Start

Read the 'SKILL.md' file for the skill unit 'authoring-agent-skills' to understand the conventions for creating agent skills.

Frequently Asked Questions about authoring-agent-skills

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

FAQPage Schema
What is the best way to create AI skills for Claude Code?โ–ผ

To write effective AI skills, structure SKILL.md files with clear naming, frontmatter, and examples. Following the Weakest-Reader Principle ensures your instructions remain understandable by agents with limited reasoning capacity.

How do I structure an AI skill for the Anthropic Skills API?โ–ผ

Structure an AI skill for the Anthropic Skills API by defining clear frontmatter, naming conventions, and references in a SKILL.md file. This ensures runtime robustness and reliable deployment across both Claude Code and the API.

Does the Anthropic Skills API support skills designed for Claude Code?โ–ผ

Yes, the Anthropic Skills API supports Claude Code skills. Following specific deployment guidelines ensures your agent skills maintain runtime robustness and function reliably across both environments.

Why are my AI agent skills not working reliably?โ–ผ

AI agent skills may fail if they lack runtime robustness or are not structured for agents with limited reasoning capacity. Using clear examples, proper paths, and the recommended SKILL.md structure prevents these failures.

When do I need to use the Weakest-Reader Principle for skill creation?โ–ผ

You need to use the Weakest-Reader Principle during skill creation to ensure your instructions are understandable by an agent with limited reasoning capacity. It guarantees your AI skills remain clear, effective, and maintainable.

What are the guidelines for naming and deploying AI skills?โ–ผ

Guidelines for naming and deploying AI skills involve structuring frontmatter for discoverability and following specific deployment rules for the Anthropic Skills API. This ensures clear presentation and reliable runtime execution.