Skip to main content

Documentation Index

Fetch the complete documentation index at: https://agentic.proxify.io/llms.txt

Use this file to discover all available pages before exploring further.

Official reference — For plugin.json schema and SKILL.md frontmatter spec, see the official plugin docs and skills authoring docs. This page covers why you want a personal workspace and how to set one up.
Claude Code has layers: ~/.claude/CLAUDE.md for global preferences, project CLAUDE.md for repo-specific context, community skills for your tech stack. But there’s a layer missing from most setups — your own tooling. The skills, agents, hooks, and workflows you build to make Claude work the way you work. That’s your personal plugin workspace. It’s a directory in your home folder that acts as your Claude operating system: meta-skills that improve how Claude reasons, custom agents for how you review code, slash commands for your daily workflows, hooks that enforce your standards. It loads in every session, across every codebase. Think of it as your dotfiles for Claude.

​
Where It Fits

Claude Code already has global config (~/.claude/CLAUDE.md) and per-project config. Your workspace is a different thing entirely — it’s not configuration, it’s tooling.
LayerWhat it isExample
~/.claude/CLAUDE.mdGlobal preferences”I prefer concise responses”
Project CLAUDE.mdRepo-specific context”Run npm test, we use Prisma”
Community skillsTech stack patternsReact, Tailwind, Zod conventions
Your workspaceYour meta-toolingDecision frameworks, custom agents, workflow commands, context auditors
The first three tell Claude what to know. Your workspace tells Claude how to operate.

​
Set It Up

One command: 
npx new-claude-plugin my-workspace
This creates: 
~/my-workspace/
├── .claude-plugin/
│   └── plugin.json
├── skills/
│   └── hello/
│       └── SKILL.md     # Starter skill — rename and fill in
└── README.md
The interactive prompts let you opt into agents, hooks, and MCP servers. Start with just a skill — you can add the rest later.

​
Load It

Point Claude at your workspace to start using it: 
claude --plugin-dir ~/my-workspace
Hot-reload while you’re editing, without restarting: 
/reload-plugins
When it’s stable, install it permanently so it loads in every session: 
/plugin marketplace add ~/my-workspace
StageHow to loadWhen
Trying it outclaude --plugin-dir ~/my-workspaceFirst day
Daily driver/plugin marketplace add ~/my-workspaceAfter a week of use
Sharing with your teamPush to GitHub, /plugin marketplace add owner/repoWhen others want it

​
What Belongs Here

Anything that makes Claude better at working your way, regardless of the project you’re in.
Skills that improve how Claude operates — not domain knowledge, but operational tooling:
  • A decision framework for where new knowledge should live (CLAUDE.md vs skill vs agent)
  • A context auditor that shows which skills consume the most tokens
  • A skill architecture guide that teaches Claude how to build better skills
Write skill descriptions as “use when” rules — that’s how Claude decides whether to load them: 
---
name: skill-architecture
description: >-
  How to design skills that actually reach agents at the right time.
  Use when creating, restructuring, or auditing skills.
---
Not here: project-specific build commands (that’s CLAUDE.md), tech stack patterns a community skill already covers (install those instead), or things that change every sprint (too volatile to codify).

​
Growing It

Start with one skill. Add the next piece when you catch yourself working around a gap. As your workspace matures, organize by concern — keep meta-tooling, domain skills, and workflow commands in separate plugins under one repo. A marketplace.json at the root lets you manage multiple plugins together. See the official plugin docs for the marketplace structure. When something in your personal workspace turns out to be useful for your whole team, extract it into a shared plugin. Your workspace stays yours.

​
Anti-Patterns

Don’t confuse config with tooling. Global preferences go in ~/.claude/CLAUDE.md. Project context goes in your project’s CLAUDE.md. Your workspace is for tools that change how Claude operates — see Context Distribution. Don’t skip the trial period. Use --plugin-dir mode for a week before installing permanently. If a skill’s description never triggers, rewrite it. If you keep editing the body, it’s not ready. Don’t build a monolith. If your workspace grows past 5–6 unrelated skills, split by concern. Meta-tooling, workflow commands, and domain skills have different lifecycles.