Skip to main content

Skills

Skills are reusable SKILL.md instructions that the CLI loads on demand. Create one folder per skill:

.neusiscode/skills/my-skill/
├── SKILL.md           # Required: frontmatter + content
└── references/        # Optional: extra context files

Built-in skill​

Neusis Code ships one skill out of the box: customize-neusiscode. It is registered in the binary itself — you do not install or configure it, and it is enabled by default. It loads when the model is asked to edit Neusis Code's own configuration (for example neusiscode.json, files under .neusiscode/, or files under ~/.config/neusiscode/) so the agent works from the real config schema instead of guessing.

The skill links the full configuration JSON Schema:

neusis.ai/config.json

When a field's exact shape is unclear, the agent fetches that schema and reads it directly rather than guessing — Neusis Code hard-fails on invalid config, so a wrong shape means a broken startup. For where config files live and how they merge, see Configuration.

:::note Override it with your own The built-in skill is registered before disk discovery, so a skill you place on disk with the name customize-neusiscode takes precedence and replaces it. :::

Frontmatter​

---
name: my-skill
description: What this skill does
---

Skill name rules​

  • Lowercase alphanumeric
  • Single hyphens allowed
  • 1–64 characters
  • Must match the directory name

Discovery locations​

  • .neusiscode/skills/
  • .claude/skills/
  • .agents/skills/

Each of the above is checked at both the project and global level.

Remote skills​

Remote skills can be synced via skills.urls in config — the CLI fetches an index.json from the URL and pulls the referenced skill folders.