Skills

What skills do

Skills are instruction bundles for the agent. They are loaded from ~/.openneko/skills at agent-turn time and can be installed from a git URL, from a monorepo subpath, or as a bundled folder declared by a plugin package.

Skills follow the agentskills.io SKILL.md format. OpenNeko parses frontmatter such as name, description, license, tags, related_skills, and prerequisites.

Install skills

# Repository root contains SKILL.md
openneko install https://github.com/owner/repo

# Monorepo subpath
openneko install https://github.com/owner/repo#skills/apple/apple-notes

Bundled skills

A plugin package can declare openneko.skill in package.json. During install, OpenNeko copies that folder into ~/.openneko/skills using the skill frontmatter name when present.

{
  "name": "@example/openneko-plugin",
  "openneko": {
    "skill": "./skill"
  }
}

Create skills

The agent runtime exposes a neko_skills MCP server with a create_skill tool. Created skills are written as SKILL.md files and committed through config version control, so improvements to team-specific agent behavior can be reviewed over time.

• Keep skill instructions narrow and operational.
• Prefer concrete examples over broad policy prose.
• Declare prerequisites when a skill assumes a tool, service, or credential.
• Run pnpm skills:check in source development to validate packaged skills.