Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.ntrp.io/llms.txt

Use this file to discover all available pages before exploring further.

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-skillCreate or remove a user skill
/add-toolCreate a user-defined tool
/obsidianWork with Obsidian vaults through the official obsidian CLI or an external MCP server

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:6877/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. Restart the server after creating a skill manually so the registry rescans skills/, .skills/, and ~/.ntrp/skills/. Skills installed through the API are reloaded automatically.

Managing skills

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