Menu
Resolve and use a durable private home directory at ~/.agents/home/{identifier} for agent-only notes, scripts, caches, drafts, and other state that must persist across sessions.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
Capture iterative design explorations by naming the session, maintaining notes, and delaying implementation until clarity emerges. Use when the user is probing ambiguous architecture, system behavior, agent design, workflow design, product design, protocol design, meta-prompting/skill design, implementation strategy, or another complex design space across alternatives, objections, revisions, tradeoffs, ownership boundaries, invariants, failure modes, or integration risks. Complexity alone is not enough: use only when the user is exploring, probing, revising, comparing, or converging over time. Do not use for simple factual questions, clear implementation/edit requests, code review, CI fixes, releases, direct GitHub/PR work, simple prompt rewriting or one-shot prompt optimization, or when notes cannot be written.
Learn durable procedures from repeated delegation. Use when an agent should recognize a recurring request, recover how this user expects it done, execute from a lightweight runbook, or turn a successful new task into reusable procedural memory without making the user design the process.
Publish durable spoken updates and answerable spoken questions through a standalone TTS29 daemon. Use when the user requests narration, a voice update, spoken progress, cross-device speech, or a bounded spoken question. The skill is a producer adapter only; it does not synthesize, pair devices, own playback, or run Nostr.
Record evidence-based feedback after using another skill. Use when real use exposes unclear, missing, stale, inefficient, rigid, or ineffective guidance, a trigger misfire, or a skill-caused correction. Create or append canonical issues in the target skill's meta-feedback directory; exclude speculative reviews and general editing.
Explore a topic, codebase, system, document, tool, workflow, or unfamiliar concept and explain it succinctly at a high level for a user who does not want or need deep internals. Use when the user asks for a plain-language overview, "what is this?", "how does this work at a high level?", "help me understand", "explain without overwhelming me", "summarize the architecture", "give me the mental model", or similar broad orientation.
Use when turning an open-source repository into a project people understand, want to try, trust, star, share, or contribute to. Applies to README rewrites, launch preparation, repo audits, skill catalogs, CLI/library/app/framework/MCP/template repos, agent-facing repos, and root-structure recommendations. Separates human-facing positioning from agent-router metadata and produces adoption copy, proof, quick starts, trust signals, and maintainable repo shape.
| name | home-directory |
| description | Resolve and use a durable private home directory at ~/.agents/home/{identifier} for agent-only notes, scripts, caches, drafts, and other state that must persist across sessions. |
Use one durable directory for private state that belongs to this agent across sessions. Do not use it for project-shared files, team-owned state, or recreatable build output.
Store agent-only persistent state under:
~/.agents/home/{identifier}/
Resolve {identifier} at agent scope:
Agent,
Session, and Backend, use Agent.codex, claude, or
harry.[a-z0-9._-] with -,
collapsing repeated -, and trimming leading or trailing -.agent if normalization is empty.Create the directory before using it and write private persistent files only inside it.
Pass the resolved agent identity explicitly when it is known:
~/.agents/skills/home-directory/scripts/resolve-home-directory.sh codex
With no argument, the helper checks common runtime-provided agent identity and
name values, then falls back to agent.
Suitable contents include private notes, helper scripts, lightweight caches, drafts, logs, and artifacts needed by later sessions of the same agent.