shaping-work skillA
shaping-work is agent-read markdown (skill) from teambrilliant/dev-skills: Shape rough ideas into clear, actionable work definitions. Use this skill whenever someone has an unstructured idea that needs to become a concrete work definition — feature requests, bug reports, PRDs, customer feedback, Slack threads, stakeholder asks, or vague "we should do X" statements. Trigger phrases include "shape this", "scope this", "write a PRD", "define this work", "turn this into a ticket", "flesh this out", "spec this out", "what should we build for X", "I have an idea for...", or .
Indexed from public GitHub and served as immutable, content-addressed versions. Install it pinned to an exact SHA-256 with the mdr CLI, and every file is verified before it reaches your agent: the main file against the SHA-256 recorded here, the others against the git hashes of its source commit. The deterministic audit below grades the latest version, and the same checks always give the same file the same grade.
What the file says
# Shaping Work Shape ambiguous ideas into clear work definitions. Focus on clarity, not process theater. ## Principles - **No jargon** — write so anyone can understand - **Product-focused** — define *what*, not *how* to build it - **Right level of detail** — enough to act on, not a specification - **Flag unknowns with recommendations** — surface risks early, but always propose a resolution ## Process 1. **Understand the request** — Read the input (could be anything: a Slack thread, a rough idea, a customer complaint, a formal PRD, or a handoff from product-thinker). If intent is unclear, ask up to 3 targeted questions, then shape with stated assumptions. 2. **Understand the context** — If handed off from product-thinker, use the product context and analysis already gathered (don't re-explore). Otherwise, if working in a codebase, read `.tap/product.md` if it exists (current focus, bets, non-goals — what this work has to ladder up to), then CLAUDE.md or similar to understand what the application does (the product, not technical details). Also look for related context the request didn't mention: existing docs on the topic in `thoughts/shapes/`, `thoughts/plans/`… …
Read the whole file at its exact version.
How to install
mdr add teambrilliant/dev-skills/shaping-work@git:20260927.b9558d0mdr add teambrilliant/dev-skills/shaping-work@sha256:fec59ae5c3946158Pin to a label to follow the author's releases, or to a sha256 for exact bytes. Either way the resolved hash is written to mdr.lock, and mdr install fetches those bytes again and checks them, so it installs them exactly or fails.
[](https://markdownregistry.com/a/art_kxefjqowkvmnbcbe)
0 badge views in 30 days
Versions
| version | committed | commit | size | audit | |
|---|---|---|---|---|---|
| git:20260927.b9558d0 latest | 2026-09-27 | b9558d0 | 19,354 B | A | view · diff |
| git:20260807.eadd958 | 2026-08-07 | eadd958 | 17,233 B | A | view · diff |
| git:20260713.f906cdf | 2026-07-13 | f906cdf | 15,340 B | A | view · diff |
| git:20260711.4b8d7f9 | 2026-07-11 | 4b8d7f9 | 15,203 B | A | view · diff |
| git:20260707.e955c58 | 2026-07-07 | e955c58 | 13,253 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 (19354 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
teambrilliant/dev-skills · 6 stars · license none · pushed 2026-09-27 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_kxefjqowkvmnbcbe GET https://markdownregistry.com/api/v1/resolve?ref=teambrilliant/dev-skills/shaping-work GET https://markdownregistry.com/api/v1/blob/fec59ae5c3946158d3f17f91c7874e649b8d0eb4cd9efd88d145dad45b489153
Your agent 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.