Agent skills

Install Naumu's skills from the public registry so your agents run the team's read+write loop, import whole archives, and log work done in the Claude apps.

Updated September 23, 20263 min read

Skills are packaged instructions your coding agent discovers and follows - Claude Code, Codex, Cursor, and any harness that reads an .agents/skills/ or .claude/skills/ directory. Naumu ships three through the public registry at github.com/naumu-ai/skills:

The naumu skill - the daily loop. Before a substantive task, the agent runs one fast retrieval against your space so it starts with the team's prior decisions; when the work is done, it files a short work-log entry and links the thread from the commit.
The naumu-import skill - a one-off importer. Point it at a folder or an export (doc dumps, ticket archives with comment chains, images, PDFs, audio, video) and it lands the material in your existing space as searchable notes, uploaded media, and - if you want - typed nodes on the graph.
The naumu-worklog skill - the work log for non-coding work outside a repo. It opens a thread when a work session starts, follows up on decisions, and posts a summary when done. Claude and ChatGPT save it from one pasted setup prompt rather than npx; other apps save the same loop to their memory or instructions. In a coding repo it stands down so it never double-logs next to the naumu skill.

This page assumes your team is already set up: the Naumu MCP server is connected and your space exists. If not, start with Local MCP or run the full Repo quickstart, which performs this install as one of its steps.

Install

One command installs the skills for the current developer:

bash

npx skills add naumu-ai/skills

To pin the whole team to a fixed release instead of tracking the latest:

bash

npx skills add naumu-ai/[email protected]

The installer writes the skills under .agents/skills/ with a .claude/skills/ symlink. Commit those files - git tracks them fine, and every teammate and fresh clone then gets the skills without re-running the installer.

Update

Re-run the same command to pick up the latest published release:

bash

npx skills update

npx skills add naumu-ai/skills does the same thing. Note that updating overwrites the managed skill directories - if you have deliberately forked a skill locally, move it out of the managed paths first.

Each skill has its own page: The naumu skill covers the read+write loop, the .naumu tracking block, and the commit trailer; The naumu-import skill covers invoking an import, the consent gate, and resuming interrupted runs.

Keeping the MCP server current

Both skills talk to your space through the Naumu MCP server, and newer skill releases can depend on newer server tools. Each skill states the minimum @naumu/mcp version it needs in its SKILL.md. If a skill reports a missing naumu_* tool, your running server predates the skill - update and reconnect:

Remote connection (https://naumu.ai/api/mcp): reconnect the server - in Claude Code, run /mcp and reconnect, or restart the session.
Local @naumu/mcp binary: update the package (npm i -g @naumu/mcp@latest or clear the npx cache), then restart the session so the new toolset loads.