maintainable-tests skillA
maintainable-tests is agent-read markdown (skill) from jpcaparas/skills: Guide maintainable tests as behavior documentation with isolated side effects, compatibility coverage, and reliable assertions. Use for tests, fixtures, mocks, regressions, reviews, and testability changes. Skip disposable work..
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 against the hash recorded here before it reaches your agent. The deterministic audit below grades the latest version, and the same file always earns the same grade.
What the file says
# maintainable-tests Write, edit, refactor, and review tests so a developer returning months later can understand the behavior, the edge cases, and the reason each important test exists. ## Passive Trigger Load this skill in the background whenever the task involves automated tests, examples used as tests, fixtures, mocks, stubs, fakes, test data builders, regression coverage, characterization tests, flaky tests, or production-code changes made to improve testability. Keep it lightweight for small edits: apply the core rules silently, then mention only the test-design decisions that affect the final implementation. ## Decision Tree What are you doing? - Adding tests for new behavior: Read `references/principles.md` and `references/naming-and-intent.md`. Name each test after the user-visible rule or domain invariant, then use concrete examples that teach the behavior. - Fixing a bug or adding regression coverage: Read `references/legacy-and-characterization.md`. The test should explain the broken scenario, expected behavior, and why this coverage remains valuable after the fix. - Covering edge cases: …
Read the whole file at its exact version.
How to install
mdr add jpcaparas/skills/maintainable-tests@v1.1.0mdr add jpcaparas/skills/maintainable-tests@sha256:39382c3e62d03f3aPin to a label to follow the author's releases, or to a sha256 to freeze the exact bytes forever. Either way the resolved hash is written to mdr.lock, and mdr install reproduces it on any machine.
[](https://markdownregistry.com/a/art_zg6fa3dnqlglaftp)
1 badge views in 30 days
Versions
| version | committed | commit | size | audit | |
|---|---|---|---|---|---|
| v1.1.0 latest | 2026-09-15 | 12d6015 | 12,835 B | A | view · diff |
| v1.1.0 | 2026-09-12 | 938fe03 | 12,865 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 (12835 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 · 51 stars · license none · pushed 2026-09-20 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_zg6fa3dnqlglaftp GET https://markdownregistry.com/api/v1/resolve?ref=jpcaparas/skills/maintainable-tests GET https://markdownregistry.com/api/v1/blob/39382c3e62d03f3aa1c812078720131b7afa6126c8b1dedae19b97d765151242
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.