developer-troubleshooting-docs SKILL.md skillA

developer-troubleshooting-docs from samber/developer-relations-skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add samber/developer-relations-skills/developer-troubleshooting-docs@v1.0.2

Pins v1.0.2 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
samber/developer-relations-skills
Path
skills/developer-troubleshooting-docs/SKILL.md
Versions recorded
5
Latest version
v1.0.2, committed Oct 25, 2026
First version recorded
Sep 1, 2026
Size
26,743 bytes
Repository stars
8
License
MIT

Turns support tickets, issue history and error telemetry into troubleshooting and error-reference pages a developer finds by pasting the error string - symptom, conditions, cause, fix and verification entries, an error-code catalog generated from one source of truth, and fixes wired back into the product's own error output. Use whenever the user mentions troubleshooting docs, documenting error codes, error message pages, a known-issues page, building an FAQ from support tickets, or…

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

# Developer Troubleshooting Docs

You are a technical writer who works from failure evidence. A team keeps answering the same failures in tickets, issues, and chat, and the answers never reach the docs. Turn that history into pages a developer lands on by pasting the error string, and make each page end with the reader unblocked instead of writing a ticket.

You choose which failures deserve a page, write the entries, verify the fixes, and wire the pages to where the failure happens. You do not debug the user's current incident, rewrite the product's error strings, or run site-wide SEO. When one of these is the real request, route it:

- Docs placement and coverage across the whole set → samber/developer-relations-skills@developer-docs-structure-audit
- First-run success → samber/developer-relations-skills@developer-quickstart-guide
- Upgrade failures caused by a breaking change → samber/developer-relations-skills@version-migration-guide
- "Fixed in version X" wording → samber/developer-relations-skills@changelog-writing
- Mining technical search demand → samber/developer-relations-skills@developer-keyword-research
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add samber/developer-relations-skills/developer-troubleshooting-docs@sha256:5228a4d558abf566

The line at the top of this page pins the label v1.0.2, 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.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_tisdkpqg5gprb476.svg)](https://markdownregistry.com/a/art_tisdkpqg5gprb476)

2 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 5 versions of this file, between Sep 1, 2026 and Oct 25, 2026, about one every 14 days.

versioncommittedcommitsizeaudit
v1.0.2 latest2026-10-25 2c2141c 26,743 BA view · diff
v1.0.12026-10-21 d18c14c 26,708 BA view · diff
v1.0.12026-10-20 ff16f68 26,547 BA view · diff
v1.0.12026-09-27 bc8ac6d 26,403 BA view · diff
v1.0.02026-09-01 255462a 26,038 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (26743 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

GitHub

samber/developer-relations-skills · 8 stars · license MIT · pushed 2026-11-01 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_tisdkpqg5gprb476
GET https://markdownregistry.com/api/v1/resolve?ref=samber/developer-relations-skills/developer-troubleshooting-docs
GET https://markdownregistry.com/api/v1/blob/5228a4d558abf566900155d351ed8a2974a284605103f0e027087100e6753d05

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.

More from samber/developer-relations-skills

bluesky-dev-playbook SKILL.md skill
samber/developer-relations-skills · skills/bluesky-dev-playbook/SKILL.md · Runs a devtool vendor's, developer advocate's or open-source maintainer's presence on Bluesky - go-or-skip verdict…
v1.0.0 · audit A · 8 stars
build-in-public SKILL.md skill
samber/developer-relations-skills · skills/build-in-public/SKILL.md · Designs a sustainable build-in-public practice for an open-source project or developer tool: how far up the disclosure…
v1.0.5 · audit A · 8 stars
changelog-writing SKILL.md skill
samber/developer-relations-skills · skills/changelog-writing/SKILL.md · Turns raw commits, pull requests and tickets into release notes developers actually read - a scannable record of what…
v1.0.4 · audit A · 8 stars
coding-agent-docs-optimization SKILL.md skill
samber/developer-relations-skills · skills/coding-agent-docs-optimization/SKILL.md · Makes SDK, API or protocol documentation something a coding agent can integrate from unattended - crawler access…
v1.0.3 · audit A · 8 stars
conference-cfp-submission SKILL.md skill
samber/developer-relations-skills · skills/conference-cfp-submission/SKILL.md · Turns a talk idea into a submission-ready conference proposal for one specific event, or helps choose which conferences…
v1.0.2 · audit A · 8 stars
dailydev-playbook SKILL.md skill
samber/developer-relations-skills · skills/dailydev-playbook/SKILL.md · Runs a devtool vendor's or maintainer's presence on daily.dev - entry path (indexed source, New Post, own Squad…
v1.0.0 · audit A · 8 stars
developer-booth-playbook SKILL.md skill
samber/developer-relations-skills · skills/developer-booth-playbook/SKILL.md · Writes an exhibiting company's own playbook for an in-person booth at a developer conference: who works it and how many…
v1.0.0 · audit A · 8 stars
developer-case-study SKILL.md skill
samber/developer-relations-skills · skills/developer-case-study/SKILL.md · Turns a customer's real production deployment into a technical case study engineers believe - measured numbers tied…
v1.0.2 · audit A · 8 stars
developer-certification-program SKILL.md skill
samber/developer-relations-skills · skills/developer-certification-program/SKILL.md · Plans the issuer side of a developer certification or badge program, mostly for freelancers and IT services firms who…
v1.0.2 · audit A · 8 stars
developer-champions SKILL.md skill
samber/developer-relations-skills · skills/developer-champions/SKILL.md · Designs an unpaid, perks-only developer champions or ambassador program end to end - readiness check, intake model…
v1.0.1 · audit A · 8 stars
developer-community-health SKILL.md skill
samber/developer-relations-skills · skills/developer-community-health/SKILL.md · Designs and runs a developer community health measurement framework: activity, responsiveness, contributor-funnel and…
v1.0.1 · audit A · 8 stars
developer-community-launch SKILL.md skill
samber/developer-relations-skills · skills/developer-community-launch/SKILL.md · Decides whether, where and when to launch a developer community, then plans its seeding and first 90 days - venue…
v1.0.1 · audit A · 8 stars

Every file in samber/developer-relations-skills

Browse by kind, by grade A, or by owner.