Skip to main content
Discover and install skills that extend what your agents can do. AgentHeaven can export toolkits as Skills — a natural-language-centric protocol for presenting tools and knowledge to LLMs.

​
What is a Skill?

A Skill is a folder containing a SKILL.md file that describes what the skill does, how to invoke it, and what resources it needs. Optionally, a skill folder can include Python scripts, reference documentation, resources, and licenses. Skills are intended for LLM consumption — unlike traditional API docs, the descriptions are written in natural language so that an LLM can understand when and how to use the tools.

​
Creating Skills from Toolkits

Any AgentHeaven toolkit can be exported as a skill: 
from ahvn import Toolkit, ToolSpec

toolkit = Toolkit(
    name="weather",
    description="Get current weather for any city.",
    tools={"get_weather": ToolSpec.from_func(get_weather)},
)

# Export to a skill folder
toolkit.export("./skills/")
This generates a skills/weather/SKILL.md file with the toolkit’s name, description, and tool signatures.
The built-in export covers basic descriptions. For production-quality skills, customize the generated SKILL.md or use SkillUKFT (see Knowledge) to enrich descriptions with domain knowledge.

​
Skill Structure

skills/weather/
├── SKILL.md          # Required — name, description, triggers, tool signatures
├── scripts/          # Optional — Python helper scripts
├── resources/        # Optional — reference data, examples
└── LICENSE           # Optional
The SKILL.md frontmatter follows the Skills protocol convention: 
---
name: weather
description: Get current weather for any city.
---

## Tools

### get_weather
Get the current weather for a given city name.
...

​
Further Exploration

Related:
  • Toolkits — build the toolkits that become skills
  • MCP — serve toolkits as MCP servers instead of skills
  • Knowledge — SkillUKFT for enriched skill descriptions