designing-agent-skills SKILL.md skillA
designing-agent-skills from bdsqqq/dots is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.
mdr add bdsqqq/dots/designing-agent-skills@git:20260929.dbd7dd9Pins git:20260929.dbd7dd9 in mdr.lock. Pin the fingerprint instead.
- Audit grade
- A, 17 of 17 checks passed
- Kind
- SKILL.md skill
- Repository
- bdsqqq/dots
- Path
modules/agents/skills/designing-agent-skills/SKILL.md- Versions recorded
- 1
- Latest version
- git:20260929.dbd7dd9, committed Sep 29, 2026
- Size
- 5,551 bytes
- Repository stars
- 64
- License
- none declared
Create, revise, or evaluate reusable agent skills: triggers, procedures, references, and behavioral cases. Use when asked to write a skill, fix its selection, or improve its instructions; not when executing an existing skill or writing a one-off plan.
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
# designing agent skills make one workflow easier to execute correctly, not another collection of advice. global guidance owns voice and permissions. skill descriptions route tasks; bodies change decisions. test those contracts separately. ## diagnose before drafting 1. inspect the target skill, related workflows, and actual harness. identify a recurring correction or explicitly requested capability: **when trigger, current failure; desired decision, observable result**. 2. choose the home: deterministic invariant → executable check; project fact → repository; personal default → global guidance; reusable conditional procedure → skill. a one-off plan does not automatically deserve a skill. 3. distinguish not discovered, not selected, not loaded, ambiguous instructions, unsupported tools, and failure to follow clear guidance. another paragraph does not fix all six. ## design the contract - give the skill a coherent job. split procedures callers want independently: drafting is not publishing; filing a pull request is not monitoring it. - write descriptions in request language with meaningful exclusions. keep steps …
Read the whole file at its exact version.
How to install
mdr add bdsqqq/dots/designing-agent-skills@sha256:7433398fd5b46cc9The line at the top of this page pins the label git:20260929.dbd7dd9, 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_qxvotwcg2jgo3mlj)
2 badge image fetches in 30 days. What the badge shows.
Versions
The registry has recorded 1 version of this file, committed on Sep 29, 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 (5551 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
bdsqqq/dots · 64 stars · license none declared · pushed 2026-10-22 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_qxvotwcg2jgo3mlj GET https://markdownregistry.com/api/v1/resolve?ref=bdsqqq/dots/designing-agent-skills GET https://markdownregistry.com/api/v1/blob/7433398fd5b46cc9b6bf094e326964fd1838861671913fb95f7d950e3cbb9c04
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.