OpenParable
Skip to content
← Back to skills

Dotagents

Agent Building
dotagents

Dotagents 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.

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
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:

DocumentRead When
references/cli-reference.mdFull command options, flags, examples
references/configuration.mdEditing agents.toml, source formats, trust, MCP, hooks, wildcards, scopes
references/config-schema.mdExact 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

CommandDescription
dotagents initInitialize agents.toml and .agents/ directory
dotagents installInstall 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 syncReconcile state (adopt orphans, repair symlinks, verify integrity)
dotagents listShow installed skills and their status
dotagents mcpAdd, 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

FormatExampleDescription
GitHub shorthandgetsentry/skillsOwner/repo (resolves to GitHub HTTPS)
GitHub pinnedgetsentry/[email protected]With tag, branch, or commit
GitHub SSH[email protected]:owner/repo.gitSSH clone URL
GitHub HTTPShttps://github.com/owner/repoFull HTTPS URL
Git URLgit:https://git.corp.dev/team/skillsAny non-GitHub git remote
Local pathpath:./my-skills/customRelative to project root

Key Concepts

  • .agents/skills/ is the canonical home for all installed skills
  • agents.toml declares dependencies; agents.lock pins exact commits and integrity hashes
  • Symlinks: .claude/skills/, .cursor/skills/ point to .agents/skills/
  • Wildcards: name = "*" installs all skills from a source, with optional exclude list
  • 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: --user flag manages skills in ~/.agents/ shared across all projects