Skill audit report

api Audit report.

Use to derive the API contract for a feature — an OpenAPI 3.1 document at docs/features/{slug}/contracts/openapi.yaml plus a drift/sync report (and an events doc when the feature has async flows). Triggers on "api for {slug}", "openapi for {slug}", "API contract for {slug}", "lock the interface for {slug}", "events for {slug}", "/sdd:api {slug}", "контракт API для {slug}", "OpenAPI для {slug}", "опиши ендпоінти". The contract is never hand-written: it is a derived function of data-model.md (typed fields + constraints), the sad.md §6 sequence diagrams (error branches, async actors), and spec.md acceptance criteria. Runs an inline drift check (does the contract match the model and the sequences?) and a reconcile mode. Hard-refuse if data-model.md is missing AND the feature changes the schema → run `data-model {slug}` first; on a legal no-schema-change skip it derives from the existing schema instead.

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

OpenAgentSkill Trust Score

70
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

62

119 GitHub stars

Stars/forks activity

WARN

57

119 stars, 46 forks; issue activity unavailable in current metadata

Recent maintenance

PASS

88

2mo since push

License clarity

PASS

86

MIT

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 genkovich/sdd --skill api

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/genkovich/sdd/tree/main/skills/api

Review status

PASS

88

AI review data available

Agent Proven outcomes

INFO

54

No agent outcome data yet

Checks

Install and adoption review

7 Passed · 10 Needs review

Install path

92

PASS

npx skills add genkovich/sdd --skill api

Repository

88

PASS

https://github.com/genkovich/sdd/tree/main/skills/api

License

86

PASS

MIT

Maintenance

88

PASS

2mo since push

AI review

88

PASS

Approved with no listed issues

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

57

FIX

119 stars, 46 forks; issue activity unavailable in current metadata

Adoption

68

INFO

119 GitHub stars

Warnings

  • Dependency or permission surface needs review
  • Permission surface may require sandboxing
  • Quality score needs review
  • Permission surface needs review: secrets or environment access, shell or command execution
  • Stars/forks activity: 119 stars, 46 forks; issue activity unavailable in current metadata
  • 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