Dotagents
Agent BuildingdotagentsDotagents is an Agent Skill for agent building published in the getsentry/sentry-javascript repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
Manage agent skill dependencies with dotagents. Use when asked to "add a skill", "install skills", "remove a skill", "update skills", "dotagents init", "agents.toml", "agents.lock", "sync skills", "list skills", "set up dotagents", "configure trust", "add MCP server", "add hook", "wildcard skills", "user scope", or any dotagents-related task.
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Inspect the Agent Skill at https://github.com/getsentry/sentry-javascript/blob/HEAD/.agents/skills/dotagents/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/dotagents, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
Manage agent skill dependencies declared in agents.toml. dotagents resolves, installs, and symlinks skills so multiple agent tools (Claude Code, Cursor, Codex, VS Code, OpenCode) discover them from .agents/skills/.
Running dotagents
If dotagents is not available as a direct command, use npx @sentry/dotagents instead. For example: npx @sentry/dotagents sync. All commands and flags work the same way.
References
Read the relevant reference when the task requires deeper detail:
| Document | Read When |
|---|---|
| references/cli-reference.md | Full command options, flags, examples |
| references/configuration.md | Editing agents.toml, source formats, trust, MCP, hooks, wildcards, scopes |
| references/config-schema.md | Exact field names, types, and defaults |
Quick Start
# Initialize a new project (interactive TUI)
dotagents init
# Add a skill from GitHub
dotagents add getsentry/skills find-bugs
# Add multiple skills at once
dotagents add getsentry/skills find-bugs code-review commit
# Add all skills from a repo
dotagents add getsentry/skills --all
# Add a pinned skill
dotagents add getsentry/[email protected]
# Install all dependencies from agents.toml
dotagents install
# List installed skills
dotagents list
Commands
| Command | Description |
|---|---|
dotagents init | Initialize agents.toml and .agents/ directory |
dotagents install | Install all skills from agents.toml |
dotagents add <specifier> | Add a skill dependency |
dotagents remove <name> | Remove a skill |
dotagents update [name] | Update skills to latest versions |
dotagents sync | Reconcile state (adopt orphans, repair symlinks, verify integrity) |
dotagents list | Show installed skills and their status |
dotagents mcp | Add, remove, or list MCP server declarations |
All commands accept --user to operate on user scope (~/.agents/) instead of the current project.
For full options and flags, read references/cli-reference.md.
Source Formats
| Format | Example | Description |
|---|---|---|
| GitHub shorthand | getsentry/skills | Owner/repo (resolves to GitHub HTTPS) |
| GitHub pinned | getsentry/[email protected] | With tag, branch, or commit |
| GitHub SSH | [email protected]:owner/repo.git | SSH clone URL |
| GitHub HTTPS | https://github.com/owner/repo | Full HTTPS URL |
| Git URL | git:https://git.corp.dev/team/skills | Any non-GitHub git remote |
| Local path | path:./my-skills/custom | Relative to project root |
Key Concepts
.agents/skills/is the canonical home for all installed skillsagents.tomldeclares dependencies;agents.lockpins exact commits and integrity hashes- Symlinks:
.claude/skills/,.cursor/skills/point to.agents/skills/ - Wildcards:
name = "*"installs all skills from a source, with optionalexcludelist - Trust: Optional
[trust]section restricts which sources are allowed - Hooks:
[[hooks]]declarations write tool-event hooks to each agent's config - Gitignore: When
gitignore = true, managed skills are gitignored; custom in-place skills are tracked - User scope:
--userflag manages skills in~/.agents/shared across all projects