feat: improved the Claude Kit as a plugin

website/src/content/docs/customization/creating-agents-and-modes.md

@@ -15,13 +15,11 @@ Agents are specialized subagents that Claude dispatches for independent, focused
 
 ### Agent Structure
 
-Agent files live in `.claude/agents/`:
+Plugin agents live in the `agents/` directory at the plugin root. For project-specific agents, create them in `.claude/agents/`:
 
 ```
 .claude/agents/
-├── code-reviewer.md
-├── debugger.md
-└── my-custom-agent.md
+├── my-custom-agent.md
 ```
 
 ### Agent File Format
@@ -105,13 +103,13 @@ Modes change Claude's communication style, output format, and problem-solving ap
 
 ### Mode Structure
 
-Mode files live in `.claude/modes/`:
+After running `/claudekit:init`, built-in modes are installed to `.claude/modes/`. You can add custom modes alongside them:
 
 ```
 .claude/modes/
-├── brainstorm.md
-├── implementation.md
-└── my-custom-mode.md
+├── brainstorm.md          # Installed by /claudekit:init
+├── implementation.md      # Installed by /claudekit:init
+└── my-custom-mode.md      # Your custom mode
 ```
 
 ### Mode File Format

website/src/content/docs/customization/creating-skills.md

@@ -9,7 +9,7 @@ Skills are the core building block of Claude Kit. You can create custom skills f
 
 ## Skill Structure
 
-Each skill is a directory in `.claude/skills/` containing a `SKILL.md` file:
+Plugin skills live in the `skills/` directory at the plugin root. For project-specific skills, create them in `.claude/skills/`:
 
 ```
 .claude/skills/
@@ -103,7 +103,7 @@ description: Authentication skill for handling auth stuff.
 For complex skills, include reference documents in a `resources/` subdirectory:
 
 ```
-.claude/skills/my-framework/
+my-framework/
 ├── SKILL.md
 └── resources/
     ├── api-reference.md      # Framework API docs
@@ -190,5 +190,5 @@ description: Use when deploying to Fly.io or configuring Fly.io
 
 ## Related Pages
 
-- [Skills Reference](/claudekit/reference/skills/) — All 43 built-in skills
+- [Skills Reference](/claudekit/reference/skills/) — All 44 built-in skills
 - [Creating Agents & Modes](/claudekit/customization/creating-agents-and-modes/) — Custom agents and modes