idiomatic SKILL.md skillA
idiomatic from jpcaparas/skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.
mdr add jpcaparas/skills/idiomatic@git:20260926.1532075Pins git:20260926.1532075 in mdr.lock. Pin the fingerprint instead.
- Audit grade
- A, 17 of 17 checks passed
- Kind
- SKILL.md skill
- Repository
- jpcaparas/skills
- Path
skills/engineering/idiomatic/SKILL.md- Versions recorded
- 1
- Latest version
- git:20260926.1532075, committed Sep 26, 2026
- Size
- 15,689 bytes
- Repository stars
- 56
- License
- none declared
Audits a workspace against its actual framework, library and paradigm contracts, then proposes a phased, resumable alignment plan or executes approved phases. Use for legacy modernisation, framework-convention drift and structural debt; not routine bug fixes or cosmetic style reviews.
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
# idiomatic Make a project easier to change by working with its frameworks, not against them. Preserve the hard-won behaviour that keeps it running. Deliver a concrete plan people can defend, approve and complete in independent sessions; execute it when that is the user's intent. ## Establish the mandate Infer intent from the conversation and inspect what the workspace can answer before questioning the user. - **Plan or endorsement first:** inspect and propose; do not edit application code, configuration, data or infrastructure. Describe proposed harnesses and commands, rather than building them without authority. Run only checks whose effects are safe for this mode. - **Plan and execute:** explain the approach, then carry out the authorised local phases and verification. Do not turn an already-authorised implementation into a second approval ceremony. …
Read the whole file at its exact version.
How to install
mdr add jpcaparas/skills/idiomatic@sha256:5c9e8c7bdd128a52The line at the top of this page pins the label git:20260926.1532075, 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_mbigpwpcxmzxabp4)
4 badge image fetches in 30 days. What the badge shows.
Versions
The registry has recorded 1 version of this file, committed on Sep 26, 2026.
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 (15689 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
jpcaparas/skills · 56 stars · license none declared · pushed 2026-11-03 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_mbigpwpcxmzxabp4 GET https://markdownregistry.com/api/v1/resolve?ref=jpcaparas/skills/idiomatic GET https://markdownregistry.com/api/v1/blob/5c9e8c7bdd128a52bda70e4d3027c938d4d0d16d10909a4517dd7e345de6eb4b
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.