@nakirosai/nakiros

Is your Claude Code skill actually worth keeping?

Local daemon + web UI that audits, evaluates, fixes, and creates Claude Code skills. Many skills add nothing; some make Claude worse. Nakiros tells you which ones to keep, improve, or drop — with real eval runs, all on your machine.

Install

npm i -g @nakirosai/nakiros

Then, anywhere:

nakiros

The daemon starts on http://localhost:4242 and opens your default browser.

Requirements

• Node.js ≥ 20
• Claude Code installed (the daemon reads from ~/.claude/ to discover your projects and skills)

What it does

• Scan — discovers every skill in your Claude projects and in ~/.claude/skills
• Audit — runs a structured quality audit on any skill (trigger description, references, outputs, examples)
• Evaluate — spins up an isolated copy of a skill and runs a suite of evals with/without the skill, so you can compare
• Fix — iterate on a skill in a temp workdir, re-run evals against the baseline, ship when better
• Create — draft a new skill from scratch, evaluate it before deployment

All data stays on your machine. No account, no cloud, no telemetry.

CLI options

nakiros [options]

  --port <n>   Preferred port (default 4242 or $NAKIROS_PORT).
               Falls back to next free port if taken.
  --no-open    Do not open the browser automatically.
  -h, --help   Show help.

Press Ctrl+C to stop the daemon.

Run as a background service

If you want Nakiros to start at login and keep running in the background (useful once it begins observing live conversations), install it as a service:

nakiros service install     # registers an autostart and starts the daemon
nakiros service status      # shows running state and PID
nakiros service stop        # stops until the next start (persistent)
nakiros service start       # resumes
nakiros service uninstall   # removes the autostart entry

Under the hood:

• macOS — writes a LaunchAgent at ~/Library/LaunchAgents/com.nakiros.daemon.plist. The daemon restarts automatically if it crashes (KeepAlive) and starts at login (RunAtLoad).
• Linux — writes a systemd user unit at ~/.config/systemd/user/nakiros.service with Restart=always and enables it for the default target.
• Windows — not yet supported. Run nakiros manually for now.

Logs land in ~/.nakiros/logs/daemon.out.log and daemon.err.log.

The service must point at a stable binary path. If you installed via npx, run npm i -g @nakirosai/nakiros first — nakiros service install will refuse to register a path inside the npx cache.

Links

• Website: https://nakiros.com
• Repository: https://github.com/NakirosAI/nakiros
• Issues: https://github.com/NakirosAI/nakiros/issues

License

MIT © NakirosAI