diff --git a/agents/iannuttall__claude-agents/README.md b/agents/iannuttall__claude-agents/README.md
new file mode 100644
index 0000000..2758175
--- /dev/null
+++ b/agents/iannuttall__claude-agents/README.md
@@ -0,0 +1,36 @@
+# claude-agents
+
+A curated library of **seven Claude Code custom sub-agents** by [@iannuttall](https://github.com/iannuttall), covering the full software-development lifecycle. Drop any agent into `.claude/agents/` and Claude Code automatically selects the right specialist for each task.
+
+## Available agents
+
+| Agent | What it does |
+|---|---|
+| **code-refactorer** | Improves code structure, readability, and maintainability without changing behaviour |
+| **security-auditor** | Performs comprehensive security audits and produces prioritised remediation reports |
+| **prd-writer** | Creates detailed, structured Product Requirements Documents |
+| **project-task-planner** | Converts a PRD into a fully-phased development task list |
+| **frontend-designer** | Translates mockups and wireframes into component specs and design systems |
+| **content-writer** | Produces high-quality written content for a wide range of purposes |
+| **vibe-coding-coach** | Translates app ideas and aesthetic preferences into working software |
+
+## Installation
+
+```bash
+# Project-scoped
+mkdir -p .claude/agents
+cp agents/*.md .claude/agents/
+
+# Global (all projects)
+mkdir -p ~/.claude/agents
+cp agents/*.md ~/.claude/agents/
+```
+
+## Usage
+
+Once installed, Claude Code detects and delegates tasks to the appropriate agent automatically — no extra configuration needed.
+
+## Links
+
+- Repository: https://github.com/iannuttall/claude-agents
+- License: MIT
diff --git a/agents/iannuttall__claude-agents/metadata.json b/agents/iannuttall__claude-agents/metadata.json
new file mode 100644
index 0000000..d2de9a3
--- /dev/null
+++ b/agents/iannuttall__claude-agents/metadata.json
@@ -0,0 +1,14 @@
+{
+  "name": "claude-agents",
+  "author": "iannuttall",
+  "description": "Seven Claude Code sub-agents covering the full dev lifecycle: code refactoring, security auditing, PRD writing, task planning, frontend design, content writing, and vibe coaching.",
+  "repository": "https://github.com/iannuttall/claude-agents",
+  "version": "1.0.0",
+  "category": "developer-tools",
+  "tags": ["claude-code", "sub-agents", "code-refactoring", "security", "prd", "frontend", "productivity"],
+  "license": "MIT",
+  "model": "claude-sonnet-4-5-20250929",
+  "adapters": ["claude-code", "system-prompt"],
+  "icon": false,
+  "banner": false
+}