improve-loop SKILL.md skillA
improve-loop from tomcounsell/ai is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.
mdr add tomcounsell/ai/improve-loop@git:20261027.b1054fcPins git:20261027.b1054fc in mdr.lock. Pin the fingerprint instead.
- Audit grade
- A, 17 of 17 checks passed
- Kind
- SKILL.md skill
- Repository
- tomcounsell/ai
- Path
skills/valor/bama/skills/ship/improve-loop/SKILL.md- Versions recorded
- 1
- Latest version
- git:20261027.b1054fc, committed Oct 27, 2026
- Size
- 4,723 bytes
- Repository stars
- 32
- License
- GPL-3.0
Autonomous loop that works through docs/STORIES.md one story at a time for a macOS app, building, snapshotting, comparing against reference screenshots, fixing, and committing, until a milestone is done. Use when the user says "keep going", "work through the backlog", "make it match the reference", or wants an unattended improvement loop.
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
# Improve loop One pass through the loop takes one story from `todo` to `done`: ```text pick story -> plan -> code -> ./build.sh -> snapshot -> compare -> fix -> commit -> update STORIES.md ``` Stop after the milestone the user named, or after the current milestone if they named none. Then report. ## 1. Pick Open `docs/STORIES.md`. Take the first `todo` story in the current milestone whose dependencies are `done`. Set it to `doing`. ## 2. Plan If the story adds a screen, an action, or words and has no `UX:` block yet, call the Skill tool with `ux-design` first. Write two to five lines in your head or in the commit body: which files change, which model fields are new, which menu command and shortcut it adds, which snapshot page shows it. If the story needs a new SwiftData field, give it a default value so existing databases keep loading. ## 3. Code Follow the `swift-swiftui` and `mac-design` skills, the story's `UX:` block, and `design/DESIGN-SYSTEM.md` if the app has one. System hooks follow `os-integrations`. Keep each view file under about 300 lines. Put new pages in the `SidebarItem` enum so snapshot mode visits them. ## 4. Build and snapshot …
Read the whole file at its exact version.
How to install
mdr add tomcounsell/ai/improve-loop@sha256:3edae75dafd3ed51The line at the top of this page pins the label git:20261027.b1054fc, 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_5rrvndzvwj66gkpk)
2 badge image fetches in 30 days. What the badge shows.
Versions
The registry has recorded 1 version of this file, committed on Oct 27, 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 (4723 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
tomcounsell/ai · 32 stars · license GPL-3.0 · pushed 2026-11-05 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_5rrvndzvwj66gkpk GET https://markdownregistry.com/api/v1/resolve?ref=tomcounsell/ai/improve-loop GET https://markdownregistry.com/api/v1/blob/3edae75dafd3ed5157098b871f65ba2f9ca71dc82eb570540f23b8b89dbb7c52
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.