Skip to content
Back to search

nori-skillsets

System for managing collections of agent skills. Switch between skillsets seamlessly!

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/tilework-tech--nori-skillsets/badge.svg)](/listings/tilework-tech--nori-skillsets)

HTML

<a href="/listings/tilework-tech--nori-skillsets"><img src="/api/listings/tilework-tech--nori-skillsets/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Install the client:

npm install -g nori-skillsets

Run init to set up a skillsets folder at cwd/.nori/profiles and capture your existing configs. Note that this will set up in the folder that you run the command in, allowing you to scope skillsets by project.

nori-skillsets init

Download a skillset from noriskillsets.dev.

nori-skillsets download senior-swe

Switch to using the new skillset.

nori-skillsets switch senior-swe

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 153 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # Nori Skillsets Client
  2. [![CI](https://github.com/tilework-tech/nori-skillsets/actions/workflows/ci.yml/badge.svg)](https://github.com/tilework-tech/nori-skillsets/actions/workflows/ci.yml)
  3. [![npm version](https://img.shields.io/npm/v/nori-skillsets)](https://www.npmjs.com/package/nori-skillsets)
  4. [![npm license](https://img.shields.io/npm/l/nori-skillsets)](https://www.npmjs.com/package/nori-skillsets)
  5. [![npm downloads](https://img.shields.io/npm/dm/nori-skillsets)](https://www.npmjs.com/package/nori-skillsets)
  6. **CLI Client for installing and managing Nori Skillsets**
  7. The Nori Skillsets Client connects you to [noriskillsets.dev](https://noriskillsets.dev/), a registry of verified agent Skills and packaged agent configurations. Install complete Skillsets or individual Skills that have been reviewed for effectiveness, clarity, and proper implementation.
  8. The client supports a wide range of coding agents (Claude Code, Cursor, Codex, Gemini CLI, GitHub Copilot, OpenCode, Goose, Kilo, Kimi CLI, Pi, OpenClaw, Droid). Each agent receives a translation of the same skillset into the format it expects on disk.
  9. For complete documentation and to browse available Skillsets, visit:
  10. - **Skillsets Registry**: [noriskillsets.dev](https://noriskillsets.dev/)
  11. - **Documentation**: [noriskillsets.dev/docs](https://noriskillsets.dev/docs/building-a-skillset)
  12. ## What is a Skillset?
  13. A Skillset is a complete, unified configuration that defines how your coding agent behaves. Skillsets can include:
  14. - **Skills**: Step-by-step instructions that encode specific agent behaviors (TDD, debugging, code review, git workflows)
  15. - **AGENTS.md / CLAUDE.md**: Custom instructions and workflow preferences that guide the agent
  16. - **Subagents**: Specialized agents for specific tasks (codebase search, documentation, research)
  17. - **Slash Commands**: Quick actions that invoke Skills and workflows
  18. - **MCP servers**: Bundled Model Context Protocol server configs translated into each agent's expected format at install time (e.g., `.mcp.json` for Claude, `config.toml` for Codex, `settings.json` for Gemini, `mcp.json` for Cursor)
  19. ## Installation
  20. Install the client:
  21. ```bash
  22. npm install -g nori-skillsets
  23. ```
  24. Run init to set up a skillsets folder at cwd/.nori/profiles and capture your existing configs.
  25. Note that this will set up in the folder that you run the command in, allowing you to scope skillsets by project.
  26. ```bash
  27. nori-skillsets init
  28. ```
  29. Download a skillset from noriskillsets.dev.
  30. ```bash
  31. nori-skillsets download senior-swe
  32. ```
  33. Switch to using the new skillset.
  34. ```bash
  35. nori-skillsets switch senior-swe
  36. ```
  37. ## How Skillsets Work
  38. Skillsets are stored in `~/.nori/profiles/` as your library of available configurations. When you switch to a Skillset, the client writes its contents into the relevant locations for each configured agent (e.g., `.claude/` for Claude Code, `.cursor/` for Cursor, `.codex/` for Codex, `.gemini/` for Gemini CLI). Configure which agents to target with `nori-skillsets config`.
  39. **Skillset Structure:**
  40. ```
  41. ~/.nori/profiles/my-skillset/
  42. ├── AGENTS.md # Custom instructions (CLAUDE.md also supported)
  43. ├── nori.json # Skillset manifest (name, version, dependencies, requiredEnv)
  44. ├── skills/ # Skill definitions
  45. │ ├── my-skill/
  46. │ │ └── SKILL.md
  47. │ └── another-skill/
  48. │ └── SKILL.md
  49. ├── subagents/ # Subagent configurations
  50. ├── slashcommands/ # Custom slash commands
  51. └── mcp/ # Canonical MCP server configs (one JSON file per server)
  52. ```
  53. When you activate a Skillset:
  54. 1. The client cleans any existing configuration in each configured agent's directory
  55. 2. Translates the skillset into the format each agent expects and writes it to the corresponding agent directory
  56. 3. Each agent reads the new configuration in its next session
  57. This separation lets you maintain multiple Skillsets, target multiple agents at once, and switch between them without losing any configuration.
  58. ## Requirements
  59. - Node.js 22 or higher
  60. - At least one supported coding agent CLI installed (Claude Code, Cursor, Codex, Gemini CLI, etc.)
  61. - Mac or Linux operating system
  62. ## Creating custom skillsets or making changes to skillsets
  63. 1. Create the skillset directory:
  64. ```bash
  65. mkdir -p ~/.nori/profiles/my-skillset
  66. ```
  67. 2. Add an `AGENTS.md` file with your custom instructions:
  68. ```markdown
  69. # My Custom Skillset
  70. Add your workflow preferences here:
  71. - Testing requirements
  72. - Git automation rules
  73. - Code style guidelines
  74. - Any repeating instructions
  75. ```
  76. 3. Activate your skillset:
  77. ```bash
  78. nori-skillsets switch my-skillset
  79. ```
  80. Manual changes made to an agent's installed directory (e.g., `.claude/`, `.cursor/`, `.codex/`) will be removed when switching skillsets. Manual changes should be made in the `~/.nori/profiles/<skillset-name>/` directory instead.
  81. ### Writing content for more than one agent
  82. Agents name their tools differently — Claude Code has `TaskCreate`, Codex has `update_plan`. Rather than forking a skill per agent, mark the differences inline and Nori keeps only the part that applies to whichever agent it is installing for:
  83. ```markdown
  84. Track work with {{claude-code TaskCreate}}{{codex update_plan}}{{else your plan tool}} first.
  85. ```
  86. For anything longer than a phrase, use the block form:
  87. ```markdown
  88. {{#claude-code}}
  89. Multi-line guidance for Claude Code.
  90. {{else codex}}
  91. Multi-line guidance for Codex.
  92. {{else}}
  93. Guidance for everyone else.
  94. {{/}}
  95. ```
  96. The same file installed for Claude Code and for Codex produces two different results. Tags naming anything that is not a known agent are left alone, and fenced code blocks are never touched.
  97. Run `nori-skillsets syntax` for the full reference, including comma lists, negation, and the `{{skills_dir}}`-style path placeholders.
  98. ## Private Skillsets for Teams
  99. Teams can set up private registries to share custom Skillsets across the organization. With private registries:
  100. - Full access control - only your organization can view and install
  101. - Package working configurations and publish internally
  102. - Teammates install the exact setup that proved successful
  103. - Optional Skills Review service: professional evaluation before publication
  104. Contact us at [noriagentic.com](https://noriagentic.com) to set up a private registry for your team.
  105. ## Resources
  106. - **Skillsets Registry**: [noriskillsets.dev](https://noriskillsets.dev/)
  107. - **Documentation**: [noriskillsets.dev/docs](https://noriskillsets.dev/docs/building-a-skillset)
  108. - **GitHub**: [github.com/tilework-tech/nori-skillsets](https://github.com/tilework-tech/nori-skillsets)
  109. - **npm**: [npmjs.com/package/nori-skillsets](https://www.npmjs.com/package/nori-skillsets)
  110. - **Contact**: [noriagentic.com](https://noriagentic.com)

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.