Skills

Skills are reusable instruction bundles that the agent loads on demand using the Skill tool. Each skill is a SKILL.md file plus optional scripts stored in <cwd>/.agentix/skills/<name>/.

Skill file format

---
name: skill-name
description: One-line description of what this skill does.
user-invocable: true
---

# Skill Title

Detailed instructions for the agent when this skill is loaded...

Discovery order

The agent discovers skills from:

1. <cwd>/.agentix/skills/ — project-local skills
2. ~/.agentix/skills/ — user-global skills
3. Built-in skills (always available)

Built-in skills

Skill	Description
pdf	Read and extract text from PDF files
docx	Read Microsoft Word documents
pptx	Read PowerPoint presentations
xlsx	Read Excel spreadsheets

Creating a skill

my-project/
└── .agentix/
    └── skills/
        └── deploy/
            ├── SKILL.md
            └── deploy.sh

SKILL.md:

---
name: deploy
description: Deploy the application to the target environment.
user-invocable: true
---

# Deploy

To deploy the application:
1. Run `./deploy.sh <environment>` with the target environment name.
2. Monitor the output for errors.
3. Confirm the deployment URL is live.

How skills are used

The agent uses the Skill tool to load a skill's instructions on demand:

User: /deploy    ← triggers the "deploy" skill if user-invocable: true

Important: Never read SKILL.md files directly in code. The agent discovers and loads skills through the Skill tool automatically.

user-invocable

When user-invocable: true, users can invoke the skill directly with a /skill-name slash command in interactive sessions.