librefang-registry/skills/README.md

Skills

Reusable skill definitions for LibreFang agents. Skills are either prompt templates or code scripts that agents can invoke to perform specific tasks.

Structure

skills/
├── custom-skill-prompt/
│   └── skill.toml           # Prompt-only skill
└── custom-skill-python/
    ├── skill.toml            # Skill manifest
    └── main.py               # Python implementation

Skill Types

Prompt-Only

No code needed -- pure prompt engineering:

[skill]
name = "meeting-agenda"
version = "0.1.0"
description = "Generate a structured meeting agenda"
tags = ["meeting", "productivity"]

[runtime]
type = "promptonly"

[input]
topic = { type = "string", description = "The meeting topic", required = true }
duration_minutes = { type = "string", description = "Duration in minutes", required = true }

[prompt]
template = """
Create a meeting agenda for:
Topic: {{topic}}
Duration: {{duration_minutes}} minutes
"""

Python

Custom logic with a Python entry point:

[skill]
name = "my-skill"
version = "0.1.0"
description = "Skill with custom logic"

[runtime]
type = "python"
entry = "main.py"

[input]
data = { type = "string", description = "Input data", required = true }

Other Runtimes

Also supported: node, shell.

Testing Skills Locally

librefang skill test ./skills/custom-skill-prompt \
  --input '{"topic": "Q1 planning", "duration_minutes": "30"}'

Adding a New Skill

1. Create skills/<name>/skill.toml
2. Add implementation files if not promptonly
3. Run python scripts/validate.py
4. Submit a PR

See CONTRIBUTING.md for the full guide.