Skill audit report

dx-roaster Audit report.

Brutally honest developer-experience audit for a GitHub repo. Scores 10 DX dimensions (time-to-first-success, README clarity, visual proof, install, quick-start, docs, examples, community, trust, marketing), writes a shareable roast in the requested tone (brutal/honest/kind), produces a prioritized action plan ranked by impact × effort, and sketches an ideal README. Trigger when user says "roast my repo", "audit my README", "dx audit", "developer experience review", "score my GitHub project", "before launch checklist", or "make my repo shareable".

EXPERIMENTAL · REVIEWNeeds reviewGenerated Nov 5, 2026Heuristic metadata audit
76
Audit
70
Trust
72
Quality
76
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

76

635 GitHub stars

Stars/forks activity

INFO

71

635 stars, 68 forks; issue activity unavailable in current metadata

Recent maintenance

PASS

88

3mo since push

License clarity

PASS

86

MIT

README/SKILL.md completeness

PASS

86

Metadata includes enough usage and workflow context

Dependency/runtime risk

INFO

64

command execution surface, network or browser surface

Install availability

PASS

92

npx skills add Varnan-Tech/opendirectory --skill dx-roaster

Install command safety

PASS

92

standard package or runtime install path

Permission surface

WARN

48

shell or command execution, filesystem or document access

Repository evidence

PASS

86

https://github.com/Varnan-Tech/opendirectory/tree/main/skills/dx-roaster

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 · 10 Needs review

Install path

92

PASS

npx skills add Varnan-Tech/opendirectory --skill dx-roaster

Repository

88

PASS

https://github.com/Varnan-Tech/opendirectory/tree/main/skills/dx-roaster

License

86

PASS

MIT

Maintenance

88

PASS

3mo since push

AI review

55

CHECK

No critical security issues found. The skill reads repository files and clones remote repos, but does not execute code or modify the target repo. It writes only to a specified output directory.

README/SKILL.md completeness

86

PASS

Usable description available

Dependency risk

64

CHECK

command execution surface, network or browser surface

Install command safety

92

PASS

standard package or runtime install path

Permission surface

48

FIX

shell or command execution, filesystem or document access

Stars/forks activity

71

CHECK

635 stars, 68 forks; issue activity unavailable in current metadata

Adoption

88

PASS

635 GitHub stars

Warnings

  • Permission surface may require sandboxing
  • No critical security issues found. The skill reads repository files and clones remote repos, but does not execute code or modify the target repo. It writes only to a specified output directory.
  • The skill relies on the `gh` CLI for remote repo metadata; if `gh` is not installed, it gracefully catches failures, but this may reduce functionality.
  • Quality score needs review
  • Permission surface needs review: shell or command execution, filesystem or document access
  • Permission surface: shell or command execution, filesystem or document access

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