Imported from OnCloud125252/dotagents (AGENTS.md). Install upstream with npx skills add OnCloud125252/dotagents. Copyright stays with the author.

dotagents

Source repo for agent customizations (skills, rules, global AGENTS.md). Supported harnesses are pi and Claude Code.

What is live

The agent reads these paths directly. Edits take effect on the next session or after a reload:

• ~/AGENTS.md → GLOBAL_AGENTS.md (symlink)
• ~/.agents/skills/ (skill discovery; Claude Code reaches it through the ~/.claude/skills symlink)
• ~/.agents/rules/ (pi-rules extension, pi only)

Nothing needs an install step.

Layout

• GLOBAL_AGENTS.md — the LIVE global instructions file
• skills/ — agent skills, one flat directory each (git-commit/, pr-review/). User-invoked-only skills carry disable-model-invocation: true and user-invocable: true in SKILL.md frontmatter
• .agents/skills/ — repo-local skills (publish/, update-dependencies/). The agent loads them only when cwd is this repo. They maintain this repo and are not meant for other projects
• rules/ — path-scoped rules; YAML frontmatter paths: globs control activation, no frontmatter = always loaded
• store/catalog.json — machine-readable catalog, regenerated by /publish
• hooks/, claude-statusline/, claude-output-styles/, helpers/ — Claude Code artifacts, kept as-is, not used by pi

Workflow

• After adding/renaming a skill, run /publish — it regenerates store/catalog.json, dependency.md, and the README, then commits and pushes
• New external tool requirements go in dependency.md (/update-dependencies scans for them)
• Rule files: one gotcha per bullet, earned from real incidents — not generic advice