Skills extend CodeBuddy with specialized expertise. In this guide, you’ll learn how to create your first skill, bundle custom scripts, and activate them during a session.

How to create a skill

A skill is defined by a directory containing a SKILL.md file. Let’s create an API Auditor skill that helps you verify if local or remote endpoints are responding correctly.

Create the directory structure

1. Run the following command to create the folders:

mkdir -p .codebuddy/skills/api-auditor/scripts

Create the definition

1. Create a file at .codebuddy/skills/api-auditor/SKILL.md. This tells the agent when to use the skill and how to behave.

---
name: api-auditor
description:
  Expertise in auditing and testing API endpoints. Use when the user asks to
  "check", "test", or "audit" a URL or API.
---

# API Auditor Instructions

You act as a QA engineer specialized in API reliability. When this skill is
active, you MUST:

1. **Audit**: Use the bundled `scripts/audit.js` utility to check the
   status of the provided URL.
2. **Report**: Analyze the output (status codes, latency) and explain any
   failures in plain English.
3. **Secure**: Remind the user if they are testing a sensitive endpoint
   without an `https://` protocol.

Add the tool logic

Skills can bundle resources like scripts.

1. Create a file at .codebuddy/skills/api-auditor/scripts/audit.js. This is the code the agent will run.

.codebuddy/skills/api-auditor/scripts/audit.js

const url = process.argv[2];

if (!url) {
  console.error("Usage: node audit.js <url>");
  process.exit(1);
}

console.log(`Auditing ${url}...`);
fetch(url, { method: "HEAD" })
  .then((r) => console.log(`Result: Success (Status ${r.status})`))
  .catch((e) => console.error(`Result: Failed (${e.message})`));

How to verify discovery

CodeBuddy automatically discovers skills in the .codebuddy/skills directory. Check that it found your new skill.

Command: /skills list

You should see api-auditor in the list of available skills.

How to use the skill

Now, try it out. Start a new session and ask a question that triggers the skill’s description.

User: “Can you audit http://localhost:3000”

CodeBuddy recognizes the request matches the api-auditor description and asks for permission to activate it.

CodeBuddy: (After calling activate_skill) “I’ve activated the api-auditor skill. I’ll run the audit script now…”

CodeBuddy then uses the shell to execute your bundled Node script:

node .codebuddy/skills/api-auditor/scripts/audit.js http://localhost:3000

SKILL.md reference

The SKILL.md file uses YAML frontmatter for metadata and Markdown for instructions.

Frontmatter fields

Field	Required	Description
name	Yes	Unique identifier for the skill
description	Yes	When to activate — matched against user requests
version	No	Semantic version (e.g. 1.0.0)

Directory structure

.codebuddy/skills/
  my-skill/
    SKILL.md          # Required: Skill definition
    scripts/          # Optional: Bundled scripts
    install.sh        # Optional: Installation script
    requirements.txt  # Optional: Python dependencies

Next steps

• Browse the Skills Catalog to see built-in integrations.
• Learn about MCP Integration for connecting external tool servers.