chore: add commit skill for Claude, Cursor, and Codex

[sergical]

DESCRIBE YOUR PR

Add the commit skill from getsentry/skills for Claude Code, Cursor, and Codex agents.

• .agents/skills/commit/ — universal skill (Cursor, Codex, Cline, Gemini CLI, GitHub Copilot, etc.)
• .claude/skills/commit — symlink for Claude Code
• skills-lock.json — lock file for installed skills

IS YOUR CHANGE URGENT?

• Urgent deadline (GA date, etc.):
• Other deadline:
• None: Not urgent, can wait up to 1 week+

SLA

• Teamwork makes the dream work, so please add a reviewer to your PRs.
• Please give the docs team up to 1 week to review your PR unless you've added an urgent due date to it.
  Thanks in advance for your help!

PRE-MERGE CHECKLIST

• Checked Vercel preview for correctness, including links
• PR was reviewed and approved by any necessary SMEs (subject matter experts)
• PR was reviewed and approved by a member of the Sentry docs team

Co-Authored-By: Claude noreply@anthropic.com

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
develop-docs	Ready	Preview, Comment	Mar 5, 2026 8:16pm
sentry-docs	Ready	Preview, Comment	Mar 5, 2026 8:16pm

[szokeasaurusrex]

Wouldn't it be better to use dotagents here?

Tbh I haven't tried it out yet, but based on that docs page, this use case seems like exactly what dotagents is designed to handle -- the ability to reuse a skill defined elsewhere without needing to copy paste it.

[sfanahata]

🤖 🚀

[sentry]

Bug: The agents.toml configuration lists cursor and codex as agents, but the required symlinks (.cursor/skills, .codex/skills) are not checked into the repository, unlike .claude/skills.
_{Severity: MEDIUM}

Suggested Fix

To ensure the configuration works as intended for all declared agents without requiring an install step, check in the missing symlinks for .cursor/skills and .codex/skills. Alternatively, if support for these agents is not ready, remove cursor and codex from the agents list in agents.toml.

Prompt for AI Agent

Review the code at the location below. A potential bug has been identified by an AI
agent.
Verify if this is a real issue. If it is, propose a fix; if not, explain why it's not
valid.

Location: agents.toml#L1-L3

Potential issue: The `agents.toml` file sets `gitignore = false` and lists `cursor` and
`codex` in the `agents` field. The intent, as stated in a comment, is that collaborators
do not need to run `dotagents install`. However, while the skills and the
`.claude/skills` symlink are checked in, the corresponding symlinks for `.cursor/skills`
and `.codex/skills` are missing from the repository. Without these symlinks, Cursor and
Codex agents will fail to discover the skills unless a collaborator manually runs
`dotagents install`, which contradicts the intended setup.

[cursor]

Cursor Bugbot has reviewed your changes and found 2 potential issues.

^{Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

[cursor]

Cursor contribution guidelines deleted without equivalent replacement

Medium Severity

The 310-line .cursor/rules/contribution-guidelines.mdc is deleted but its content — covering MDX file structure, frontmatter fields, component usage (PlatformContent, OnboardingOptionButtons, alerts, expandable sections), content resolution priority, platform-specific guidelines, file naming conventions, navigation/sidebar ordering, and common anti-patterns — is not replaced by the new commit and create-branch skills. The existing .agents/skills/technical-docs/ and .agents/skills/docs-review/ only partially overlap. Cursor loses substantial project-specific documentation guidance.

 

[cursor]

Cursor lacks skills symlink unlike Claude setup

Medium Severity

agents.toml declares agents = ["claude", "cursor", "codex"] and the PR creates .claude/skills as a symlink to ../.agents/skills, but no corresponding .cursor/skills symlink or Cursor rule file is created. Since gitignore = false means skills are checked into git (no dotagents install needed), Cursor has no mechanism to discover the new skills. The PR title promises skills for Cursor but Cursor gets nothing while losing its existing rules.

Additional Locations (1)

• .claude/skills#L1

 

[sergical]

Wouldn't it be better to use dotagents here?

Tbh I haven't tried it out yet, but based on that docs page, this use case seems like exactly what dotagents is designed to handle -- the ability to reuse a skill defined elsewhere without needing to copy paste it.

i tried to use dotagents but i am not sure its properly equipped for this usecase. just doing the skills.sh installs for now