Skip to content
TakoAPI
Back to skills

skill-authoring

by kjaylee

Coding Agents & IDEs
—Not yet rated
Your rating

Brief

Guide for creating effective SKILL.md files that extend agent capabilities.

Description

What This Skill Does

A guide for writing SKILL.md files that extend agent capabilities on the agentskills.io standard. Covers frontmatter structure, conciseness principles, and freedom-level matching for different task types.

Provides explicit anti-patterns and a freedom-level framework that prevent authors from over-specifying or under-specifying agent behavior.

When to Use It

  • Writing a new SKILL.md for a custom agent workflow
  • Updating an existing skill's description to improve activation reliability
  • Teaching an agent a domain-specific process it doesn't already know
  • Deciding how prescriptive skill instructions should be for a given task
  • Splitting a large skill into SKILL.md and references/ for token efficiency

Example Workflow

INPUT

User asks: Write a SKILL.md for a code review workflow

AGENT
  1. 1

    Identify the task type and determine the appropriate freedom level (high, medium, or low)

  2. 2

    Draft frontmatter with name, description, and metadata fields

  3. 3

    Write instructions matching the chosen freedom level, using scripts or pseudocode where consistency is required

  4. 4

    Add directory structure if scripts or reference documents are needed

  5. 5

    Review for token efficiency and remove any explanations the agent already knows

OUTPUT

A complete SKILL.md file with frontmatter, structured instructions, and guardrails appropriate for the code review workflow

Installation

clawhub install kjaylee/skill-authoring

Run the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.

Links