improve-skill SKILL.md skillA

improve-skill from namedtoaster/the-last-mile is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add namedtoaster/the-last-mile/improve-skill@git:20261012.0a65810

Pins git:20261012.0a65810 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
namedtoaster/the-last-mile
Path
skills/improve-skill/SKILL.md
Versions recorded
1
Latest version
git:20261012.0a65810, committed Oct 12, 2026
Size
3,619 bytes
Repository stars
14
License
MIT

Fix a Last Mile skill that did the wrong thing, from inside the project where it went wrong. Decides whether the lesson belongs in the project's rules file or in the skill, makes the smallest change to the skill in The Last Mile repo (never the synced copy), keeps every project detail out because the repo is public, runs the checks and opens a pull request. Use when the user says a skill misfired, "improve the skill", "fix session-end", "that skill should have done X", or when session end…

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 skill

The skills get better from real use. This turns one thing that went wrong into
one small, general fix in The Last Mile, without leaking the project it happened in.

## 0. What went wrong

Write it in three lines, from the conversation:

- **Skill:** which one.
- **What it did:** the step and the result.
- **What it should have done.**

If the conversation does not make this clear, ask one question, then wait.

## 1. Decide where the fix belongs

| The lesson is... | Fix it in |
| --- | --- |
| About this project only: a command, a file, a service, an app rule | The project's rules file (`CLAUDE.md` or `AGENTS.md`): the Settings table, Gotchas or Standing decisions. Stop there. |
| About a skill listed in `keepLocal` in `.claude/last-mile/config.json` | That skill in `.claude/skills/<name>/`, which is the project's own version. Then ask whether the general version needs the same lesson; if yes, carry on below. |
| True for any app using the skill | The Last Mile, below. |

Most misfires are a missing project setting, not a broken skill. Check that first.

## 2. Reach The Last Mile

The source repo is `source` in `.claude/last-mile/config.json`
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add namedtoaster/the-last-mile/improve-skill@sha256:421f3b1068fd861b

The line at the top of this page pins the label git:20261012.0a65810, 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.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_lwxc3fiugd2upm6i.svg)](https://markdownregistry.com/a/art_lwxc3fiugd2upm6i)

1 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 1 version of this file, committed on Oct 12, 2026.

versioncommittedcommitsizeaudit
git:20261012.0a65810 latest2026-10-12 0a65810 3,619 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (3619 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

GitHub

namedtoaster/the-last-mile · 14 stars · license MIT · pushed 2026-10-21 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_lwxc3fiugd2upm6i
GET https://markdownregistry.com/api/v1/resolve?ref=namedtoaster/the-last-mile/improve-skill
GET https://markdownregistry.com/api/v1/blob/421f3b1068fd861b3d09258019b8eac52553101d15d8ef4f3f0751c945181820

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 namedtoaster/the-last-mile

CLAUDE.md@.claude CLAUDE.md file
namedtoaster/the-last-mile · .claude/CLAUDE.md
git:20261019.c868eae · audit A · 14 stars
DESIGN.md@docs DESIGN.md file
namedtoaster/the-last-mile · docs/DESIGN.md
git:20261012.abaadc0 · audit A · 14 stars
connect-tools SKILL.md skill
namedtoaster/the-last-mile · skills/connect-tools/SKILL.md · Connect Claude to the services an app already uses (RevenueCat, PostHog, Sentry, Expo, Supabase, Stripe and others)…
git:20261021.8eaa948 · audit A · 14 stars
fact-check SKILL.md skill
namedtoaster/the-last-mile · skills/fact-check/SKILL.md · Re-check stated facts about the App Store, Google Play and app tools against the current official pages, update each…
git:20261019.4cbc8ac · audit A · 14 stars
feature-demo SKILL.md skill
namedtoaster/the-last-mile · skills/feature-demo/SKILL.md · Build a tap-through demo of a feature so the person can see it before it ships, instead of reading a spec about it…
git:20261017.b3bce3d · audit A · 14 stars
lean-out SKILL.md skill
namedtoaster/the-last-mile · skills/lean-out/SKILL.md · Find the structural clutter in an app that is making every new change land wrong, and rank it by what it would have…
git:20261018.f97cc06 · audit A · 14 stars
mine-community SKILL.md skill
namedtoaster/the-last-mile · skills/mine-community/SKILL.md · Harvest a founder community (a subreddit, a forum, a newsletter archive) for what is actually working in app marketing…
git:20261020.8caec6f · audit A · 14 stars
one-time-surface SKILL.md skill
namedtoaster/the-last-mile · skills/one-time-surface/SKILL.md · Build or check a surface that is meant to appear once and then stop, such as a coach mark, tooltip, tour, primer…
git:20261018.bf92cbb · audit A · 14 stars
port-feature SKILL.md skill
namedtoaster/the-last-mile · skills/port-feature/SKILL.md · Bring a feature you already built in another of your own repos into this project. Reads the source feature end to end…
git:20261011.023ac29 · audit A · 14 stars
reference-hunt SKILL.md skill
namedtoaster/the-last-mile · skills/reference-hunt/SKILL.md · Find how real, shipped apps solve a given screen or flow, so the design starts from patterns people actually use…
git:20261011.023ac29 · audit A · 14 stars
research SKILL.md skill
namedtoaster/the-last-mile · skills/research/SKILL.md · Answer a question by searching the project's own docs and code first, then official sources, and file the dated…
git:20261011.023ac29 · audit A · 14 stars
screen-atlas SKILL.md skill
namedtoaster/the-last-mile · skills/screen-atlas/SKILL.md · Build a browsable catalogue of every screen in the app, captured from a running build and grouped into the journeys…
git:20261019.96c599a · audit A · 14 stars

Every file in namedtoaster/the-last-mile

Other files named improve-skill

improve-skill SKILL.md skill
av/skills · improve-skill/SKILL.md · Improve an existing agent SKILL.md through one gated cycle: select the target (default this skill), snapshot the…
git:20260813.b71baeb · audit A · 24 stars
improve-skill SKILL.md skill
tomzx/agents · skills/improve-skill/SKILL.md · Inspect a single skill in the library, reason about high-value low-risk improvements, and apply them directly. Used by…
git:20261007.b35fc4b · audit A · 12 stars
improve-skill SKILL.md skill
mgiovani/cc-arsenal · skills/improve-skill/SKILL.md · Improve one or more EXISTING agent skills to the current authoring standard, with measured before/after evidence…
v1.0.0 · audit A · 8 stars
improve-skill SKILL.md skill
devskale/skale-skills · deprecated/improve-skill/SKILL.md · Analyze coding agent session transcripts to improve existing skills or create new ones. Use when asked to improve a…
git:20261006.3723cb2 · audit A · 3 stars

Browse by kind, by grade A, or by owner.