~/.clawdbot vs ~/.clawd

[noble geode]

What's the default? I've ended up where both are created and its confusing to tell is one the deprecated approach?

[tame tinsel]

These are two different things, not competing approaches:

• ~/.clawdbot — State directory (config, auth, sessions, model registry)
• ~/clawd — Workspace (AGENTS.md, SOUL.md, USER.md, memory files, skills)

Both get created by default and that's correct — they're intentionally separate.

Legacy approach (deprecated): Before multi-agent support, state lived in ~/.clawdbot/agent/*. This was migrated by clawdbot doctor to ~/.clawdbot/agents/<agentId>/agent/*.

If you're seeing weird duplication like ~/.clawd/agent/*, that might be from an old PI_CODING_AGENT_DIR setup. Run clawdbot doctor to clean it up.

[noble geode]

ok where are skills load/managed? if i want to symlink skills from soemwhere else

[tame tinsel]

Skills are loaded from three places (highest to lowest precedence):

1. <workspace>/skills — per-agent, e.g., ~/clawd/skills
2. ~/.clawdbot/skills — shared across all agents
3. Bundled skills — shipped with install

You can also add extra dirs via config (lowest precedence):

{
  skills: {
    load: {
      extraDirs: ["/path/to/my/skills"]
    }
  }
}

Symlink approach: Just symlink whatever you want into ~/.clawdbot/skills or ~/clawd/skills — Clawdbot scans those directories directly. If there's a name conflict, workspace wins over managed/local.

[noble geode]

so ~/clawd/skills is a worksapce? show exmaple of what dir would look like with 3 separate workspaces. am i correct that workspaes could have their own agents?

[tame tinsel]

Yes, each workspace can have its own agent files (AGENTS.md, SOUL.md, USER.md, skills/, memory/). Here's a 3-workspace example:

~/                          # home directory
├── clawd/                  # workspace 1 (default agent "main")
│   ├── AGENTS.md
│   ├── SOUL.md
│   ├── USER.md
│   ├── memory.md
│   ├── skills/
│   │   └── custom-skill/
│   └── memory/
│       └── 2026-01-12.md
│
├── clawd-home/             # workspace 2 (agent "home")
│   ├── AGENTS.md           # different personality

│   ├── SOUL.md
│   ├── USER.md
│   ├── skills/
│   └── memory/
│
├── clawd-work/             # workspace 3 (agent "work")
│   ├── AGENTS.md           # work-focused persona
│   ├── SOUL.md
│   ├── USER.md
│   ├── skills/
│   └── memory/
│
~/.clawdbot/                # state directory (shared!)
├── clawdbot.json           # config with agents + bindings
├── skills/                 # shared skills (visible to all agents)

│   └── shared-tool/
└── agents/
    ├── main/
    │   └── agent/
    │       ├── auth-profiles.json
    │       └── models.json
    ├── home/
    │   └── agent/
    │       ├── auth-profiles.json
    │       └── models.json
    └── work/
        └── agent/
            ├── auth-profiles.json
            └── models.json