Skills

Skills are multi-file directory assets that package reusable coding-agent behaviors into a named, self-contained directory.

Directory layout

skills/
├── greeting/
│   └── SKILL.md
└── code-review/
    ├── SKILL.md
    └── examples/
        └── sample-review.md

File format

The entry point is a file named SKILL.md at the root of the skill directory (e.g., greeting/SKILL.md). It may include YAML frontmatter. Supporting files inside the directory can use any format and are deployed alongside the entry point.

Deploy behavior

nd symlinks the entire skill directory into the target location. Running nd deploy skills/greeting produces:

~/.claude/skills/greeting → <source>/skills/greeting

The agent sees the full directory contents through the symlink.

Scope rules

Related

• Asset type comparison for a side-by-side overview of all types

Create a skill

mkdir -p ~/my-assets/skills/greeting
cat > ~/my-assets/skills/greeting/SKILL.md << 'EOF'
# Greeting skill

When the user says hello, respond with a friendly greeting.
EOF
nd deploy skills/greeting