SeemSeam

Agent Roles Spec — Testing skill for Claude Code

Testing community

Agent Roles is a host-neutral specification for packaging specialist AI agents as portable, mountable Roles.

How to install Agent Roles Spec

This entry records only its repository, not the path inside it, so there is no exact command to give. Open SeemSeam/agent-roles-spec and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Agent Roles Spec does

Agent Roles is a host-neutral specification for packaging specialist AI agents as portable, mountable Roles.

Alternatives in Testing

Notion Spec To Implementation — Convert Notion specs into linked implementation plans and tasks 14.6k ★
Crlf — Test for CRLF / HTTP response-splitting and host-header injection — Set-Cookie injection, cache poisoning, res 4.5k ★
Claude Code Spec Workflow — Automated Kiro-style Spec workflow for Claude Code 3.6k ★

README

Agent Roles

Agent Roles is a host-neutral specification for packaging specialist AI agents as portable, mountable Roles.

A Role bundles everything a specialist agent needs — skills, memory, tool dependencies, plugin content, and host adapter metadata — into a single portable unit. It can be mounted into a target project's agent, then cleanly unmounted when no longer needed, without affecting the main environment, user global config, or other agents.

The specification is designed to push multi-agent collaboration toward clearer structure:

Audience	Shift
Developers	From building isolated skills to shipping complete Roles
Users	From managing scattered skills/plugins to managing roles

Languages: [简体中文](docs/i18n/README.zh-CN.md) | [日本語](docs/i18n/README.ja.md) | [繁體中文](docs/i18n/README.zh-TW.md) | [한국어](docs/i18n/README.ko.md) | [More](docs/i18n/)

Why Agent Roles

A specialist agent's content is typically scattered across multiple directories, config files, and runtimes:

System prompts
Skills pulled on demand
Project memory and long-term memory
Tool dependencies
Host-specific adapter configuration

Migrating means manually copying, installing, and debugging. Unmounting means guessing which files belong to the agent versus the main environment or other agents.

Agent Roles organizes all of this into a standardized Role format, so a specialist agent can be defined, distributed, mounted, and unmounted as a single independent unit.

Core Concepts

Role

A Role is the core object in Agent Roles — a complete specialist agent definition. It is not just a prompt and not just a skill collection; it is an encapsulation unit that carries its own capabilities, context, and adapter information.

Role Definition

A Role Definition is the manifest file for a Role. It describes the Role's responsibilities, required skills, tool dependencies, plugin content, host adapter configuration, and the ru