design-principles SKILL.md skillA
design-principles from eugenelim/agent-ready-repo is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.
mdr add eugenelim/agent-ready-repo/design-principles@git:20260918.8598e2ePins git:20260918.8598e2e in mdr.lock. Pin the fingerprint instead.
- Audit grade
- A, 17 of 17 checks passed
- Kind
- SKILL.md skill
- Repository
- eugenelim/agent-ready-repo
- Path
packs/experience-design/.apm/skills/design-principles/SKILL.md- Versions recorded
- 5
- Latest version
- git:20260918.8598e2e, committed Sep 18, 2026
- First version recorded
- Aug 10, 2026
- Size
- 11,536 bytes
- Repository stars
- 28
- License
- Apache-2.0
Use when a design team asks for durable rules that turn journey evidence and opportunity pains into consistent decisions across sprints. Produces 3–5 named design principles, each with rationale and an arbitration test. Use `creative-direction` for visual goals, `design-system` for token taxonomy, and `design-review` to evaluate existing work. Target segments and product positioning belong to product strategy; choosing and scoping a bet belongs to product engineering; encoding rules in…
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
# Skill: design-principles Converts journey-map peak moments and highest-opportunity pains into **3–5 named design principles** — decision rules that resolve disputes, survive sprint boundaries, and let every later screen point back to a principle rather than relitigating taste. The principles are **not brand values** (those belong in `creative-direction`) and **not interaction heuristics** (Nielsen's apply universally; these are specific to this product and this audience). ## Output rendering <!-- agentbundle:output-rendering:start --> Lead with the useful outcome or next action. Use warm, non-blaming language and everyday words. Define an unfamiliar term in a few plain words before naming it; keep proper names and exact technical terms intact. During tool work, do not narrate routine calls. Send an update only for safety, a blocker, a needed decision, a material scope change, a long wait, or an active host requirement. When requesting input, ask only for what is needed now. Ask dependent questions one at a time; otherwise group related questions. Offer no more than three clear choices when choices help. …
Read the whole file at its exact version.
How to install
mdr add eugenelim/agent-ready-repo/design-principles@sha256:996e7bc6c06b55e1The line at the top of this page pins the label git:20260918.8598e2e, 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_63yfg6dhd7zagfll)
2 badge image fetches in 30 days. What the badge shows.
Versions
The registry has recorded 5 versions of this file, between Aug 10, 2026 and Sep 18, 2026, about one every 10 days.
| version | committed | commit | size | audit | |
|---|---|---|---|---|---|
| git:20260918.8598e2e latest | 2026-09-18 | 8598e2e | 11,536 B | A | view · diff |
| git:20260917.9d43041 | 2026-09-17 | 9d43041 | 11,556 B | A | view · diff |
| git:20260904.b747100 | 2026-09-04 | b747100 | 10,315 B | A | view · diff |
| git:20260829.fd59e28 | 2026-08-29 | fd59e28 | 10,149 B | A | view · diff |
| git:20260810.be07f23 | 2026-08-10 | be07f23 | 7,593 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 (11536 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
eugenelim/agent-ready-repo · 28 stars · license Apache-2.0 · pushed 2026-11-06 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_63yfg6dhd7zagfll GET https://markdownregistry.com/api/v1/resolve?ref=eugenelim/agent-ready-repo/design-principles GET https://markdownregistry.com/api/v1/blob/996e7bc6c06b55e168312cc3f3e4b940c56d0b97a657ce4e6f36823c3726dd4f
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 eugenelim/agent-ready-repo
Every file in eugenelim/agent-ready-repo