ConnectorsAgent skills

Agent skills

Install the naumu and naumu-import skills from the public registry so your coding agents run the team's read+write loop and can import whole archives into your space.

Updated August 6, 20262 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 two 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.

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 both 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.

Anything missing?

Tell us what would make these docs better.

Repo quickstart The naumu skill