dx-roaster SKILL.md skillA
dx-roaster from varnan-tech/opendirectory is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.
mdr add varnan-tech/opendirectory/dx-roaster@v1.0.0Pins v1.0.0 in mdr.lock. Pin the fingerprint instead.
- Audit grade
- A, 17 of 17 checks passed
- Kind
- SKILL.md skill
- Repository
- varnan-tech/opendirectory
- Path
skills/dx-roaster/SKILL.md- Versions recorded
- 4
- Latest version
- v1.0.0, committed Sep 16, 2026
- First version recorded
- May 30, 2026
- Size
- 10,118 bytes
- Repository stars
- 688
- License
- MIT
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…
Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.
What the file says
# dx-roaster Roasts a GitHub repo's developer experience. Produces four files: `roast.md`, `action-plan.md`, `ideal-readme.md`, `score.json`. Built for OSS maintainers and dev-tool founders preparing for Show HN, Product Hunt, or any launch where the first five minutes matter. --- ## Critical rules (read before every run) 1. **Read all three reference files BEFORE scoring.** `references/scoring-rubric.md`, `references/roast-voice-guide.md`, `references/readme-template.md`. The rubric is non-negotiable — use the exact 10 dimensions. 2. **Score every dimension on the 0–10 scale. Never skip.** Missing data = score 0, not "N/A". 3. **Roast must cite specific findings.** Quote bad lines verbatim. Reference file paths. Cite line numbers when possible. Never write generic platitudes like "documentation could be better". 4. **Tone matters.** Default `honest`. Switch voice per `references/roast-voice-guide.md`. Brutal is funny but never personal. Kind is encouraging but still specific. 5. **Action plan is impact-ranked, not severity-ranked.** Use `impact × (1 / effort)`. A 5-minute fix that adds 10 points ranks above a 2-hour fix that adds 12 points. …
Read the whole file at its exact version.
How to install
mdr add varnan-tech/opendirectory/dx-roaster@sha256:766cf2a62b1dbc3cThe line at the top of this page pins the label v1.0.0, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.
[](https://markdownregistry.com/a/art_fatoawudqqluwq5g)
5 badge image fetches in 30 days. What the badge shows.
Versions
The registry has recorded 4 versions of this file, between May 30, 2026 and Sep 16, 2026, about one every 36 days.
| version | committed | commit | size | audit | |
|---|---|---|---|---|---|
| v1.0.0 latest | 2026-09-16 | a03d635 | 10,118 B | A | view · diff |
| v1.0.0 | 2026-05-30 | 33b301b | 10,175 B | A | view · diff |
| v1.0.0 | 2026-05-30 | 7dc5a4a | 10,179 B | A | view · diff |
| v1.0.0 | 2026-05-30 | 19a4893 | 8,912 B | A | view |
Audit of the latest version
- pass: Frontmatter block present
- pass: Frontmatter declares a name
- pass: Frontmatter declares a description
- pass: Size between 200 bytes and 200 KB (10118 bytes)
- pass: No zero-width or bidi control characters
- pass: No instruction hidden inside an HTML comment
- pass: No link to an exfiltration or paste host
- pass: No credential-shaped string
- pass: No instruction to send local credentials anywhere
- pass: No text hidden with inline styles
- pass: No prompt-injection phrasing
- pass: No curl or wget piped into a shell
- pass: No recursive delete of root, home or parent
- pass: No instruction to read or print local credentials
- pass: No base64 blob over 200 characters
- pass: No link to a raw IP address
- pass: No script tag
Source
varnan-tech/opendirectory · 688 stars · license MIT · pushed 2026-10-17 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_fatoawudqqluwq5g GET https://markdownregistry.com/api/v1/resolve?ref=varnan-tech/opendirectory/dx-roaster GET https://markdownregistry.com/api/v1/blob/766cf2a62b1dbc3c156e128ea9cb00a62e79f220813eeeaa4316f27587f47522
Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.
Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.