Skill audit report

document-api-endpoint Audit report.

Document and type a Sentry API endpoint. Write or fix @extend_schema decorators, specify response TypedDicts, type request parameters, correct type drift between the declared schema and the runtime response, and validate the generated spec. Use when asked to "document an endpoint", "add OpenAPI docs", "add/fix @extend_schema", "type an endpoint response", "fix the response type", "fix type drift", "reuse a response type", "split an overloaded endpoint", "specify the response schema", "add a TypedDict response", "migrate a legacy api-docs path", "fix a parameter type", or "make an endpoint public" / "promote an endpoint" (promotion is one section here).

BLOCKED · BLOCKNeeds reviewGenerated Nov 12, 2026Heuristic metadata audit
74
Audit
66
Trust
73
Quality
70
Security
88
Maintain
92
Install

OpenAgentSkill Trust Score

66
Manual review

OpenAgentSkill Trust Score

The Trust Score helps an agent decide whether a skill is safe enough to shortlist before installation.

GitHub adoption

INFO

76

979 GitHub stars

Stars/forks activity

INFO

71

979 stars, 51 forks; issue activity unavailable in current metadata

Recent maintenance

PASS

88

3mo since push

License clarity

PASS

86

Apache-2.0

README/SKILL.md completeness

PASS

86

Metadata includes enough usage and workflow context

Dependency/runtime risk

FAIL

38

command execution surface, credential or environment access

Install availability

PASS

92

npx skills add getsentry/skills --skill document-api-endpoint

Install command safety

PASS

92

standard package or runtime install path

Permission surface

FAIL

18

secrets or environment access, shell or command execution

Repository evidence

PASS

86

https://github.com/getsentry/skills/tree/main/skills/document-api-endpoint

Review status

INFO

66

AI review data available

Agent Proven outcomes

INFO

54

No agent outcome data yet

Checks

Install and adoption review

7 Passed · 12 Needs review

Install path

92

PASS

npx skills add getsentry/skills --skill document-api-endpoint

Repository

88

PASS

https://github.com/getsentry/skills/tree/main/skills/document-api-endpoint

License

86

PASS

Apache-2.0

Maintenance

88

PASS

3mo since push

AI review

55

CHECK

Security-sensitive operations such as promoting an endpoint to PUBLIC and removing it from API_OWNERSHIP_ALLOWLIST_DONT_MODIFY are documented without explicit warnings about approval, review, or broader API surface impact.

README/SKILL.md completeness

86

PASS

Usable description available

Dependency risk

38

FIX

command execution surface, credential or environment access

Install command safety

92

PASS

standard package or runtime install path

Permission surface

18

FIX

secrets or environment access, shell or command execution

Stars/forks activity

71

CHECK

979 stars, 51 forks; issue activity unavailable in current metadata

Adoption

88

PASS

979 GitHub stars

Warnings

  • Dependency or permission surface needs review
  • Permission surface may require sandboxing
  • Security-sensitive operations such as promoting an endpoint to PUBLIC and removing it from API_OWNERSHIP_ALLOWLIST_DONT_MODIFY are documented without explicit warnings about approval, review, or broader API surface impact.
  • The skill instructs using a real bearer token against a live endpoint but does not warn against exposing, committing, or logging the token.
  • Quality score needs review
  • Permission surface needs review: secrets or environment access, shell or command execution
  • Dependency/runtime risk: command execution surface, credential or environment access
  • Permission surface: secrets or environment access, shell or command execution

Method

This report combines public metadata, AI review output, repository freshness, install readiness, OpenAgentSkill events, quality scoring, trust checks, and the agent safety gate. It is not a full source-code security review.

Compare nearby options

Related skills to audit next