skills.rest
BTreeMap
BTreeMapOFFICIAL
Explore all skills by this author →
WebsiteGitHub

author-skill

Distills procedures and task histories into reusable SKILL.md files for agents.

2|2|Updated Jun 21, 2026
Search Tags:#documentation#prompt engineering#agent skills#skill authoring#spec review#skill.md#distillation
One-click install
npx skills add https://github.com/BTreeMap/SKILLs --skill author-skill-btreemap
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: author-skill
Source: https://github.com/BTreeMap/SKILLs/tree/main/author-skill
Command: npx skills add https://github.com/BTreeMap/SKILLs --skill author-skill-btreemap

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Capturing a successful workflow from an agent session and turning it into a reusable, self-contained skill is error-prone: instructions lose context, project-specific values leak in, and the result fails when a fresh agent tries to follow it. This Skill standardizes how skills are authored, refactored, and reviewed against the Agent Skills specification. ## Core Features & Use Cases - Skill Distillation: Converts a task history, workflow, or procedure into a SKILL.md that a fresh agent can execute with no memory of the original session, keeping only verified commands and actionable gotchas. - Standards Review: Audits existing skills against the Agent Skills spec, covering frontmatter fields, naming rules, description format, layout order, and XML-tagged examples. - Script Architecture Guidance: Provides placement rules for splitting responsibilities between deterministic scripts and agent judgment, including state management, CLI interface conventions, and testing practices. - Use Case: After a long debugging session where you discovered the correct deployment procedure, ask the agent to distill that session into a skill so any future agent can repeat the deployment without rediscovering the pitfalls. ## Quick Start Ask the agent to turn the procedure we just completed into a reusable skill named deploy-check.

Frequently Asked Questions about author-skill

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

FAQPage Schema
How do I turn an agent session into a reusable skill?▼

Provide the task history or procedure and ask for a skill distillation. The process keeps only verified tool calls and successful commands, writes the current rule, and preserves failures only as actionable gotchas so a fresh agent can repeat the work.

What makes a valid SKILL.md file under the Agent Skills spec?▼

A valid SKILL.md has YAML frontmatter with a name matching its directory and a third-person description ending in trigger conditions, followed by sections in execution order. Optional fields like license, compatibility, and metadata.argument-hint follow strict formatting rules.

How do I review an existing skill for spec compliance?▼

Invoke the skill with the path to the existing skill and request a review. It checks frontmatter field order, description length and form, registry and redirect sections, XML-tagged examples, and whether a fresh agent could execute the skill from its text alone.

When should logic go in a script versus the skill instructions?▼

Deterministic, byte-computable checks and stored facts belong in scripts that hard-fail on violations, while judgments about meaning, relevance, or quality stay with the agent. The skill includes a placement table that assigns each responsibility by the first matching rule.

What are the limitations of distilled skills?▼

A distilled skill only captures what was verified in the source session, so unverified steps and project-specific values must be parameterized or removed. Judgment-heavy skills should be tested with a held-out case through delegation before finalizing.

Related Skills

Explore More Software Engineering Skills→
pax-kpax-k
6

hermes-history-ingest

Ingest Hermes agent memories and session transcripts into an Obsidian wiki.

Community
Advanced
lehalpaullehalpaul

clawhub

Manage agent skills via the ClawHub CLI by searching, installing, updating, and publishing.

Community
Intermediate
chrissstelleechrissstellee

bench-skills

Benchmarks skill quality on held-out eval prompts with reproducible LLM-judge scoring.

Community
Intermediate
m2ai-portfoliom2ai-portfolio
4

agentify-docs

Convert internal documentation into agent-ready instructions with explicit boundaries.

Official
Intermediate