Skip to content

Custom Agent Skills

Freeact supports the agentskills.io specification, a lightweight format for extending agent capabilities with specialized knowledge and workflows. Skills that guide code execution are particularly well-suited for freeact's code action approach. Skills are loaded on demand: only metadata is in context initially, full instructions load when relevant.

Custom skills are installed to .agents/skills/ in the working directory. Bundled skills in .freeact/skills/ are managed automatically (see Configuration: Skills).

PDF Generation

This example uses the PDF skill from the Anthropic skills repository, a collection of production-quality skills maintained by Anthropic.

Create a workspace with a virtual environment and install the required dependencies for this example:

uv pip install reportlab

Install the PDF skill:

git clone https://github.com/anthropics/skills.git /tmp/skills
mkdir -p .agents/skills
cp -r /tmp/skills/skills/pdf .agents/skills/

Start the CLI tool:

uv run freeact

When asked to

calculate compound interest for $10,000 at 5% for 10 years, save result to output/compound_interest.pdf

the agent:

  1. Identifies the PDF skill as relevant based on the request to create a PDF document
  2. Loads the skill instructions by reading the pdf/SKILL.md file
  3. Performs the calculation and generates a PDF following the skill's guidance

Agent Skills