problem-solver SKILL.md skillA

problem-solver from tronghieu/agent-skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add tronghieu/agent-skills/problem-solver@git:20260905.623c278

Pins git:20260905.623c278 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
tronghieu/agent-skills
Path
skills/problem-solver/SKILL.md
Versions recorded
2
Latest version
git:20260905.623c278, committed Sep 5, 2026
First version recorded
Jul 18, 2026
Size
15,537 bytes
Repository stars
100
License
MIT

Diagnose problems before solving them: turn "X is broken and we don't know why" into a precise problem statement, verified root causes, solutions traced to those causes, and a rollout plan. Use whenever the user reports something failing, breaking, slowing, or recurring without a known cause: "sales dropped and we don't know why", "this keeps happening", "why does X keep failing", "find the root cause", "run a post-mortem", "5 whys"; Vietnamese "sao cứ bị vậy hoài", "tìm nguyên nhân gốc…

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

# Problem Solver

A **diagnosis-first facilitator** for problems whose cause is unknown or
unverified. The skill does two jobs that reinforce each other:

1. **Find the real cause.** Structured framing, boundary analysis, and
   root-cause methods matched to the shape of the problem — so the fix
   targets structure, not symptoms.
2. **Never fabricate.** You cannot see the user's systems, org, or
   data. Facts come from the user; everything else is a labeled
   hypothesis with a test attached. A tidy cause chain with invented
   links is worse than an honest incomplete one — it sends the user off
   to fix the wrong thing with full confidence.

The second job is the signature. Any capable model can produce a
plausible root-cause analysis; plausible is exactly the danger. What
separates diagnosis from storytelling is the discipline below.

## The evidence discipline

Three sources of truth run through every phase:

- **Facts** — things the user states from direct knowledge, or data and
  artifacts they show you. Only these earn the label `[verified]`.
- **Hypotheses** — candidate causes and links. These can come from you
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add tronghieu/agent-skills/problem-solver@sha256:cb061ea230930b15

The line at the top of this page pins the label git:20260905.623c278, 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_bky25iteblxmnw6q.svg)](https://markdownregistry.com/a/art_bky25iteblxmnw6q)

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

Versions

The registry has recorded 2 versions of this file, between Jul 18, 2026 and Sep 5, 2026, about one every 49 days.

versioncommittedcommitsizeaudit
git:20260905.623c278 latest2026-09-05 623c278 15,537 BA view · diff
git:20260718.55972852026-07-18 5597285 16,238 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 (15537 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

tronghieu/agent-skills · 100 stars · license MIT · pushed 2026-10-31 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_bky25iteblxmnw6q
GET https://markdownregistry.com/api/v1/resolve?ref=tronghieu/agent-skills/problem-solver
GET https://markdownregistry.com/api/v1/blob/cb061ea230930b155006d05fe23c06f9036fa44030a24e972a90eea1a49c21c9

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 tronghieu/agent-skills

AGENTS.md AGENTS.md file
tronghieu/agent-skills · AGENTS.md
git:20261004.2fce93c · audit A · 100 stars
CLAUDE.md CLAUDE.md file
tronghieu/agent-skills · CLAUDE.md
git:20260905.20a4e97 · audit B · 100 stars
bmad-run-inspector SKILL.md skill
tronghieu/agent-skills · skills/bmad-run-inspector/SKILL.md · Inspect and explain bmad-loop run artifacts under `.bmad-loop/runs/`. Use for live health checks ("is it stuck?", "is…
git:20261018.52461fd · audit A · 100 stars
brainstorm-coach SKILL.md skill
tronghieu/agent-skills · skills/brainstorm-coach/SKILL.md · Coach structured brainstorming sessions on any topic: diverge on ideas together, then converge on priorities and next…
git:20260905.623c278 · audit A · 100 stars
critical-thinking SKILL.md skill
tronghieu/agent-skills · skills/critical-thinking/SKILL.md · Audit the reasoning of a document or argument (memo, proposal, investment analysis, board paper, article, the user's…
git:20260905.623c278 · audit A · 100 stars
cv-scorer SKILL.md skill
tronghieu/agent-skills · skills/cv-scorer/SKILL.md · Evaluate, score, and compare candidate CVs/resumes against a job description with a shared 100-point rubric and…
git:20261031.fea59e4 · audit A · 100 stars
data-scientist SKILL.md skill
tronghieu/agent-skills · skills/data-scientist/SKILL.md · Act as an end-to-end data scientist: turn business questions into defensible analysis, validated models, and…
git:20260905.623c278 · audit A · 100 stars
deep-reader SKILL.md skill
tronghieu/agent-skills · skills/deep-reader/SKILL.md · Read, study, and answer questions about long books and papers without loading the whole text into one context window…
git:20261010.6307c5e · audit A · 100 stars
design-thinking SKILL.md skill
tronghieu/agent-skills · skills/design-thinking/SKILL.md · Facilitate a full design-thinking engagement (Empathize, Define, Ideate, Prototype, Test) grounded in real user…
git:20260905.623c278 · audit A · 100 stars
diataxis-writer SKILL.md skill
tronghieu/agent-skills · skills/diataxis-writer/SKILL.md · Write, restructure, classify, and review documentation with the Diataxis framework. Use when the user asks to create…
git:20261004.f7dd968 · audit A · 100 stars
fiction-studio SKILL.md skill
tronghieu/agent-skills · skills/fiction-studio/SKILL.md · A complete fiction-writing studio, run as a team of named specialist agents, that guides an author from a bare idea to…
git:20260615.d190775 · audit A · 100 stars
manual-tester SKILL.md skill
tronghieu/agent-skills · skills/manual-tester/SKILL.md · Plan and run manual tests of the project's running app. Runs a session in one of five modes: exploratory, verification…
git:20261004.2fce93c · audit A · 100 stars

Every file in tronghieu/agent-skills

Other files named problem-solver

problem-solver SKILL.md skill
chinkan/rustfox · skills/problem-solver/SKILL.md · Decompose and solve complex multi-step problems. Creates a todo plan before executing, then works through each step —…
git:20260614.fa02424 · audit A · 11 stars

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