owenbush/decodie-skill244 installs

decodie-flag-stale

Q: How do I install this agent skill?

Run npx skills add https://github.com/owenbush/decodie-skill --skill decodie-flag-stale.

Q: Is this agent skill safe to install?

Review the displayed partner audits, complete source, permissions, dependencies, and exact revision before installing.

Fast CI-friendly check for entries whose source files have changed since last verification. Compares entry source files against git diff without reading source code. Flags stale entries in index.json. Use in CI pipelines or before releases to detect outdated documentation.

How do I install this agent skill?

npx skills add https://github.com/owenbush/decodie-skill --skill decodie-flag-stale

view source ↗

Is this agent skill safe to install?

Gen Agent Trust Hubpass
The skill is a developer utility for identifying stale documentation entries by analyzing local git history. It executes read-only git commands and updates a local configuration file. No malicious patterns, unauthorized network access, or data exfiltration risks were detected.
Socketpass
No alerts
Snykpass
Risk: LOW · No issues

What does this agent skill do?

Decodie — Flag Stale Mode

Fast, CI-friendly counterpart to verify mode. For every entry with a verified_sha, check whether any of its source files have changed since that SHA, and flip stale: true on entries that have. Does not read source files or recompute anchor hashes — only diffs filenames against git history.

This mode modifies .decodie/index.json only.

Activation

Takes no arguments. Always operates on the full index.

Setup

Confirm .decodie/ exists. If not: "No .decodie/ directory found — nothing to check." Stop.
Confirm git repository:
```
git rev-parse --git-dir
```
If not: "Not a git repository — flag-stale requires git history. Run verify mode instead." Stop.
Read .decodie/index.json. If empty: "No entries to check." Stop.

Detection Process

For each entry:

Skip entries with no verified_sha. Report as unverified.
Skip entries with no sources (and no references[].file fallback). Report as no-sources.
Compute changed files:
```
git diff --name-only <verified_sha>..HEAD
```
If the SHA is unknown to git (history rewritten), treat as stale.
Compare changed files against entry's source files. If any match, the entry is stale.
Update:
- Newly stale → set stale: true. Leave verified_sha unchanged.
- Already stale → no change (still counted).
- No source files in diff → leave stale as-is. Do not flip stale back to fresh — only verify mode can do that.

Write updates back to index.json.

Reporting

Decodie flag-stale
  Newly stale:  N entries
  Already stale: M entries
  Fresh:        F entries
  Unverified:   U entries (no verified_sha -- run verify mode)
  No sources:   K entries

If newly stale, list them:

Newly stale:
  - entry-1711540000-a1b2 -- src/lib/foo.ts
  - entry-1711540123-c3d4 -- src/lib/bar.ts, src/lib/baz.ts

Important Notes

One-way flag. Only flips stale to true. Clearing requires verify mode.
No source file reads. Based purely on git diff --name-only. This is what makes it fast enough for CI.
No exit-code policy. Whether stale entries block a PR is a per-repo decision.
No git history rewriting. Only read-only git commands.

How can the creator link this skill?

Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.

<a href="https://skillzs.dev/skills/owenbush/decodie-skill/decodie-flag-stale">View decodie-flag-stale on skillZs</a>