understand SKILL.md skillA

understand from bjcoombs/ai-native-toolkit is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add bjcoombs/ai-native-toolkit/understand@git:20261008.d56b7ee

Pins git:20261008.d56b7ee in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
bjcoombs/ai-native-toolkit
Path
skills/understand/SKILL.md
Versions recorded
1
Latest version
git:20261008.d56b7ee, committed Oct 8, 2026
Size
2,439 bytes
Repository stars
32
License
Apache-2.0

Deep understanding mode (nemawashi) - exhaustive context-gathering before action.

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

# Deep Understanding Mode

Lay groundwork before any solution. Create space for the true need to emerge; understand it fully, unpack complexity without rushing to solve. Reach an intuitive grasp of the core issue.

Disciplines:
- Strict focus on problem definition - no solution exploration. Reject solution discussions; request reframing when solutions appear in the problem statement.
- Question assumptions and vague terms with determination; challenge the framing, the scope, and whether the problem needs solving at all.
- Hold space for ambiguity until clarity emerges; attend to context.
- Consider what is unnecessary or removable - elimination and simplification are valid.
- Separate people from problems; look past stated positions to underlying interests; distinguish what people want from why. Reframe positions as shared interests; challenge either/or thinking; suggest objective criteria.

Core questions:
- What do we mean by [key terms]?
- What explicit and implicit needs exist?
- Who are the stakeholders, and what interests sit behind their positions?
- What defines success? What objective criteria would all stakeholders accept?
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add bjcoombs/ai-native-toolkit/understand@sha256:2ee22473f642db5b

The line at the top of this page pins the label git:20261008.d56b7ee, 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_xi3uqhadu3kdfwrq.svg)](https://markdownregistry.com/a/art_xi3uqhadu3kdfwrq)

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

Versions

The registry has recorded 1 version of this file, committed on Oct 8, 2026.

versioncommittedcommitsizeaudit
git:20261008.d56b7ee latest2026-10-08 d56b7ee 2,439 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 (2439 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

bjcoombs/ai-native-toolkit · 32 stars · license Apache-2.0 · pushed 2026-10-16 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_xi3uqhadu3kdfwrq
GET https://markdownregistry.com/api/v1/resolve?ref=bjcoombs/ai-native-toolkit/understand
GET https://markdownregistry.com/api/v1/blob/2ee22473f642db5b061f9c7c26e9fa3ab539db474adeac1a4b66a90ef6efe34c

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 bjcoombs/ai-native-toolkit

CLAUDE.md CLAUDE.md file
bjcoombs/ai-native-toolkit · CLAUDE.md
git:20261011.ef225e2 · audit A · 32 stars
6hats SKILL.md skill
bjcoombs/ai-native-toolkit · skills/6hats/SKILL.md · Six Thinking Hats Analysis
git:20261008.d56b7ee · audit A · 32 stars
ab-equivalence SKILL.md skill
bjcoombs/ai-native-toolkit · skills/ab-equivalence/SKILL.md · Compare two versions of an LLM-directed document - an original (teacher) and a candidate (student) - across a transfer…
git:20260625.d42d180 · audit A · 32 stars
assess-findings SKILL.md skill
bjcoombs/ai-native-toolkit · skills/assess-findings/SKILL.md · Renders the /assess report from the deterministic run-context.json and the layer scorecard - the scorecard, the…
git:20261011.6157131 · audit A · 32 stars
assess-pr SKILL.md skill
bjcoombs/ai-native-toolkit · skills/assess-pr/SKILL.md · The /assess end-of-run offers - open a PR with the report, track the Top 3 Actions in the user's issue tracker, freeze…
git:20260919.492572b · audit A · 32 stars
assess SKILL.md skill
bjcoombs/ai-native-toolkit · skills/assess/SKILL.md · Assess a codebase's readiness for AI agent contributors using the layered contract model, and generate a complexity…
git:20261011.6157131 · audit A · 32 stars
typo SKILL.md skill
bjcoombs/ai-native-toolkit · skills/assess/tests/fixtures/claude_config_plugin/extra-skills/typo/SKILL.md · Loaded through the manifest's skills path.
git:20261008.11a01e8 · audit B · 32 stars
clean SKILL.md skill
bjcoombs/ai-native-toolkit · skills/assess/tests/fixtures/claude_config_plugin/skills/clean/SKILL.md · A skill whose every field is documented.
git:20261008.11a01e8 · audit B · 32 stars
go-conventions SKILL.md skill
bjcoombs/ai-native-toolkit · skills/assess/tests/fixtures/lean_with_skills/.claude/skills/go-conventions/SKILL.md · Go conventions for this repo. TRIGGER when editing any *.go file or Connect-Go handlers.
git:20260529.d38243f · audit A · 32 stars
java-conventions SKILL.md skill
bjcoombs/ai-native-toolkit · skills/assess/tests/fixtures/lean_with_skills/.claude/skills/java-conventions/SKILL.md · Java conventions for this repo. TRIGGER when editing any *.java file, JUnit tests, or Maven modules.
git:20260529.d38243f · audit A · 32 stars
CLAUDE.md@skills/assess/tests/fixtures/lean_with_skills CLAUDE.md file
bjcoombs/ai-native-toolkit · skills/assess/tests/fixtures/lean_with_skills/CLAUDE.md
git:20260529.d38243f · audit A · 32 stars
deslop SKILL.md skill
bjcoombs/ai-native-toolkit · skills/deslop/SKILL.md · Detect and remove the telltale signs of AI-generated 'slop' from any written text - articles, reports, emails, essays…
git:20260920.ef322b2 · audit A · 32 stars

Every file in bjcoombs/ai-native-toolkit

Other files named understand

understand SKILL.md skill
egonex-ai/understand-anything · understand-anything-plugin/skills/understand/SKILL.md · Analyze a codebase to produce an interactive knowledge graph for understanding architecture, components, and…
git:20261005.e3590a2 · audit A · 87,696 stars
understand SKILL.md skill
stevepolitodesign/skills · understand/SKILL.md · Use the Socratic method to understand something.
git:20260916.9c9c896 · audit A · 5 stars

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