Skip to main content

Overview

Skills are user-facing commands that add new functionality to ntrp. They’re distinct from tools — skills are invoked with /skill-name in chat and can orchestrate multiple tool calls.

Builtin skills

SkillDescription
/add-modelRegister a custom LLM endpoint interactively
/add-toolInstall a user-defined tool
/initInitialize memory by scanning connected sources

Skill locations

Skills are discovered from three locations (in order):
  1. skills/ — builtin skills (shipped with ntrp)
  2. .skills/ — project-level skills (per-directory)
  3. ~/.ntrp/skills/ — global user skills

Installing skills

Install a skill from GitHub:
curl -X POST http://localhost:8000/skills/install \
  -H "Authorization: Bearer $NTRP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"source": "owner/repo/path/to/skill"}'
Or ask the agent:
Install the skill from github.com/user/repo/my-skill

Creating a skill

A skill is a directory containing at minimum a SKILL.md file:
my-skill/
├── SKILL.md       # Description, parameters, instructions
└── run.py         # Optional executable
The SKILL.md tells the agent what the skill does and how to execute it. The agent follows these instructions when the user invokes /my-skill.

Managing skills

CommandDescription
GET /skillsList installed skills
DELETE /skills/{name}Uninstall a skill