arrow-maintenance SKILL.md skillA

arrow-maintenance from jszmajda/lid is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add jszmajda/lid/arrow-maintenance@git:20261012.96153e7

Pins git:20261012.96153e7 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
jszmajda/lid
Path
plugins/arrow-maintenance/skills/arrow-maintenance/SKILL.md
Versions recorded
7
Latest version
git:20261012.96153e7, committed Oct 12, 2026
First version recorded
May 14, 2026
Size
14,561 bytes
Repository stars
114
License
MIT

Navigation and audit overlay for linked-intent development. Use when working with docs/arrows/ — orienting via index.yaml, auditing spec-to-code coherence, detecting reverse orphans and drift, splitting/merging/renaming/re-parenting segments. Dual-mode: ambient guidance when the overlay is present (catch-and-recommend), or explicit /arrow-maintenance command for a directed audit-and-update pass.

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

# Arrow Maintenance

The arrow-maintenance overlay scales linked-intent-dev for projects too large to hold in one context window. It provides a navigation index, systematic audit, and brownfield bootstrap.

This skill operates in **two modes**. Detect which mode applies before acting.

## Two modes

**Ambient mode.** Auto-triggered on arrow-adjacent prompts when `docs/arrows/` exists. Posture is *catch and recommend* — notice relevant work, surface findings, edit only as the surrounding conversation authorizes. File writes happen opportunistically (e.g., updating an arrow doc's coverage table alongside a linked-intent-dev edit on the same segment). Record arrow lifecycle events (split, merge, rename, re-parent, status transitions) rather than erasing them. Do not initiate a systematic audit-and-update pass in ambient mode.

**Command mode.** Invoked explicitly as `/arrow-maintenance`. Posture is *directed action* — the user has asked for the pass. Run an audit-and-update pass, apply unambiguous fixes in place, and surface the rest for user decision. Does not pause at synthetic phase boundaries — it is a single directed pass.

## When `/arrow-maintenance` is invoked
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add jszmajda/lid/arrow-maintenance@sha256:b4eee5fbf7a9ad22

The line at the top of this page pins the label git:20261012.96153e7, 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_dievd6ruvezmf7r3.svg)](https://markdownregistry.com/a/art_dievd6ruvezmf7r3)

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

Versions

The registry has recorded 7 versions of this file, between May 14, 2026 and Oct 12, 2026, about one every 25 days.

versioncommittedcommitsizeaudit
git:20261012.96153e7 latest2026-10-12 96153e7 14,561 BA view · diff
git:20260924.c89eaf52026-09-24 c89eaf5 13,962 BA view · diff
git:20260706.343dd732026-07-06 343dd73 14,559 BA view · diff
git:20260706.b46b9e92026-07-06 b46b9e9 14,558 BA view · diff
git:20260705.8a422a62026-07-05 8a422a6 14,487 BA view · diff
git:20260529.82730532026-05-29 8273053 13,960 BA view · diff
git:20260514.1eedf562026-05-14 1eedf56 10,787 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 (14561 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

jszmajda/lid · 114 stars · license MIT · pushed 2026-10-14 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_dievd6ruvezmf7r3
GET https://markdownregistry.com/api/v1/resolve?ref=jszmajda/lid/arrow-maintenance
GET https://markdownregistry.com/api/v1/blob/b4eee5fbf7a9ad22c57b899ecbe8e61d214637e7e0df3d1cfa474fc89a48ba78

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 jszmajda/lid

AGENTS.md AGENTS.md file
jszmajda/lid · AGENTS.md
git:20261011.9779c87 · audit A · 114 stars
CLAUDE.md CLAUDE.md file
jszmajda/lid · CLAUDE.md
git:20260421.e268813 · audit B · 114 stars
DESIGN.md@docs/research/experiments/b10-differential-catch-rate DESIGN.md file
jszmajda/lid · docs/research/experiments/b10-differential-catch-rate/DESIGN.md
git:20260804.1b8713a · audit A · 114 stars
CLAUDE.md@examples/urlshort CLAUDE.md file
jszmajda/lid · examples/urlshort/CLAUDE.md
git:20260529.8273053 · audit A · 114 stars
map-codebase SKILL.md skill
jszmajda/lid · plugins/arrow-maintenance/skills/map-codebase/SKILL.md · Bootstrap LID in an existing (brownfield) codebase. Deep-reads every file in the declared scope, offers lens-based…
git:20260706.343dd73 · audit A · 114 stars
bidirectional-differential SKILL.md skill
jszmajda/lid · plugins/lid-experimental/skills/bidirectional-differential/SKILL.md · Audit coherence across an arrow of intent by running two parallel fresh Claude sessions — one reconstructs code from a…
git:20260529.8273053 · audit A · 114 stars
review-depth SKILL.md skill
jszmajda/lid · plugins/lid-experimental/skills/review-depth/SKILL.md · Experimental declared review depth for linked-intent development. Use when a LID project's instruction file declares a…
git:20261011.9779c87 · audit A · 114 stars
lid-coach SKILL.md skill
jszmajda/lid · plugins/linked-intent-dev/skills/lid-coach/SKILL.md · Review a project's current linked-intent-development (LID) usage against LID's own principles and produce a prioritized…
git:20261001.1d757f3 · audit A · 114 stars
linked-intent-dev SKILL.md skill
jszmajda/lid · plugins/linked-intent-dev/skills/linked-intent-dev/SKILL.md · Guide for linked-intent development (LID). Consult for ALL code changes. Walks changes through a mode-aware six-phase…
git:20261010.502bd52 · audit A · 114 stars
update-lid SKILL.md skill
jszmajda/lid · plugins/linked-intent-dev/skills/update-lid/SKILL.md · Configure or reconcile a project for linked-intent development (LID). Dispatches on project state — fresh bootstrap…
git:20261010.a1bb965 · audit A · 114 stars

Every file in jszmajda/lid

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