Skills System

Skills are packaged prompts and rules that load into Huginn sessions. They let you bring domain expertise into any project.

What is a skill?

A skill is a directory containing:

• A system prompt fragment (prompt.md)
• Workspace rules (rules.md)
• Metadata (skill.json)

Skill locations

Creating a skill

mkdir -p ~/.huginn/skills/go-best-practices

Create ~/.huginn/skills/go-best-practices/skill.json:

{
  "name": "go-best-practices",
  "description": "Go idioms, error handling patterns, and testing conventions"
}

Create ~/.huginn/skills/go-best-practices/prompt.md:

You are an expert Go engineer. Always:
- Use idiomatic Go error handling (errors.Is, errors.As, %w wrapping)
- Prefer table-driven tests
- Follow the standard project layout
- Use context.Context for all I/O operations

Loading skills

Skills in ~/.huginn/skills/ are loaded automatically. Reference them by name:

load skill go-best-practices

Project-local rules can be placed in .huginn/rules.md, .cursorrules, or CLAUDE.md — these are automatically injected as workspace context but are distinct from the skills system.