Profiles - Nori Documentation

What are Profiles?

Profiles are agent configurations that encode your development workflow, design standards, engineering patterns, and project context:

Configuration	Claude Code	Cursor
Behavioral Instructions	`CLAUDE.md` - Project-level instructions that guide agent behavior	`AGENTS.md` - Profile-specific instructions with mixin composition pattern
Reusable Workflows	Skills - Complex reusable workflows stored in `skills/` directory with `SKILL.md` files	Rules - Simpler markdown guidelines stored in `rules/` directory
Subagents	Native support - Specialized sub-agents for isolated tasks	Available via Nori-Profiles only - Brings subagent capability to Cursor
Slash Commands	Custom commands like `/nori-switch-profile`, `/nori-create-skill`	Custom commands like `/nori-info` for profile management
Profile Location	`~/.claude/profiles/`	`~/.cursor/profiles/`

Quick Start

Installation

Install Nori globally:

npm install -g nori-ai

Then install agent profiles:

nori-ai install

nori-ai install --agent cursor-agent

Safe Installation: Nori safely installs into your agent's config directory (~/.claude/ for Claude Code, ~/.cursor/profiles/ for Cursor). Your existing files are preserved. Use /nori-info in Cursor to see available profiles.

Profile Management

Create and switch between profiles to customize your agent's behavior:

# Create a profile /nori-create-profile # Switch profiles /command /nori-switch-profile my-custom-agent # Switch profiles Bash command nori-ai switch-profile <profile-name> --agent claude-code

# Create profiles Add directories to ~/.cursor/profiles/ with AGENTS.md and rules # Switch profiles nori-ai switch-profile <profile-name> --agent cursor-agent

Exit and re-enter your agent session to load the new profile.

CLAUDE.md and AGENTS.md

Define highest-level agent behavior and instructions in CLAUDE.md (Claude Code) or AGENTS.md (Cursor):

# Project Guidelines

## Coding Standards
- Use TypeScript strict mode
- Follow functional programming patterns
- Write unit tests for all business logic

## Workflow
1. Always run tests before committing
2. Update documentation when changing APIs
3. Use conventional commits

Skills & Rules

Skills (Claude Code) and Rules (Cursor) encode best practices, checklists, and patterns that your agent can reference.

Creating Skills & Rules

# Create a skill /nori-create-skill # Skills are stored in skills/ directories with SKILL.md files

# Create: Add RULE.md files to your profile's rules directory # Rules are markdown guidelines stored in rules/ directories

Example: Mobile Refactoring

# Mobile Refactoring Skill

When refactoring for mobile:
Check viewport meta tags
Audit touch target sizes (min 44x44px)
Test responsive breakpoints
Optimize images for mobile bandwidth
Review performance metrics

Reference Skills/Rules in your CLAUDE.md or AGENTS.md so the agent knows when to use them.

Working with Subagents

Subagents are specialized workers that the main agent can spawn to handle isolated tasks. Unlike Skills/Rules that are added to the primary agent's context, subagents run as separate sessions with their own context windows—perfect for tasks requiring focused attention without "polluting" the main agent's context.

Platform Support: Subagents are natively supported in Claude Code. For Cursor, subagent support is available exclusively through Nori-Profiles.

Subagents are referenced in AGENTS.md or CLAUDE.md files and invoked automatically when appropriate. Example subagents:

nori-knowledge-researcher: Performs research and knowledge gathering
Test Writer: Generates comprehensive test suites
Code Reviewer: Analyzes code for issues and improvements
Documentation Generator: Creates and updates documentation
Performance Analyzer: Profiles and optimizes code

Get Started

Ready to build your custom agent profiles?

GitHub →

View source code and documentation

Contact Us →

Get in touch with questions or feedback