memento:lint SKILL.md skillA

memento:lint from aiyo28/memento-os is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add aiyo28/memento-os/memento:lint@v1.0.0

Pins v1.0.0 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
aiyo28/memento-os
Path
skills/memento-lint/SKILL.md
Versions recorded
1
Latest version
v1.0.0, committed May 20, 2026
Size
4,167 bytes
Repository stars
4
License
MIT

Validate every reasoning artifact in vault _context.md tables against schema rules. [D]/[I] need an invalidates clause, [S] needs an activation clause, [E] needs a fix: line, every artifact needs # number + priority + YYYY-MM-DD date. Exit non-zero on violation so it runs as a hook or in CI. Triggers: "lint vault", "validate artifacts", "check artifact schema", "memento lint", "are my decisions valid".

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

# /memento:lint

Enforce the reasoning-artifact schema across every `_context.md` in a vault. Prose templates can't do this — that's the point.

## What gets checked

| Rule | Applies to | Required text (case-insensitive) |
|------|-----------|----------------------------------|
| R1 | `[D]`, `[I]` | `invalidates if` / `invalidates when` / `dies if` |
| R2 | `[S]` | `Activation:` / `activates when` (use `--strict` to require literal `Activation:`) |
| R3 | `[E]` | `fix:` |
| R4 | all | `#` column non-empty |
| R5 | all | priority column non-empty |
| R6 | all | row contains a `YYYY-MM-DD` date |

`[I]` shares R1 with `[D]` because the inline grammar documented in `session-complete` is identical (`[I] insight — invalidates if condition`).

## How to invoke

### Default — lint the current vault

```bash
python3 ${MEMENTO_PLUGIN_ROOT:-skills/memento-lint}/lint.py
```

The script discovers the vault root via:
1. The path argument if provided
2. The `$MEMENTO_VAULT_ROOT` env var
3. The current working directory

### Common flags

```bash
# Lint a specific vault
python3 lint.py ~/Documents/Developer/knowledge-os

# Strict mode — require literal "Activation:" for all [S]
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add aiyo28/memento-os/memento:lint@sha256:09c9e2677bf1479b

The line at the top of this page pins the label v1.0.0, 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_5u7g6h3m2hla36g7.svg)](https://markdownregistry.com/a/art_5u7g6h3m2hla36g7)

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

Versions

The registry has recorded 1 version of this file, committed on May 20, 2026.

versioncommittedcommitsizeaudit
v1.0.0 latest2026-05-20 55ae875 4,167 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 (4167 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

aiyo28/memento-os · 4 stars · license MIT · pushed 2026-10-21 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_5u7g6h3m2hla36g7
GET https://markdownregistry.com/api/v1/resolve?ref=aiyo28/memento-os/memento:lint
GET https://markdownregistry.com/api/v1/blob/09c9e2677bf1479bab5f652890f5a176c1961dfd89f2bd2464bab0835293a554

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 aiyo28/memento-os

AGENTS.md AGENTS.md file
aiyo28/memento-os · AGENTS.md
git:20260905.601aa1a · audit A · 4 stars
AGENTS.md@adapters/codex AGENTS.md file
aiyo28/memento-os · adapters/codex/AGENTS.md
git:20260520.e0e4c72 · audit A · 4 stars
decide SKILL.md skill
aiyo28/memento-os · adapters/codex/skills/decide/SKILL.md · Composable decision skill. Core OODA loop: present options, assess confidence, record reasoning artifact with priority…
v2.0.0 · audit A · 4 stars
grill-me SKILL.md skill
aiyo28/memento-os · adapters/codex/skills/grill-me/SKILL.md · Stress-test a plan, design, or architecture through relentless structured interviewing. Produces reasoning artifacts as…
v1.1.0 · audit A · 4 stars
decay SKILL.md skill
aiyo28/memento-os · adapters/codex/skills/memento-decay/SKILL.md · Find aged [D] artifacts whose invalidation triggers may have fired. Scans vault _context.md tables, parses the…
v1.0.0 · audit A · 4 stars
lint SKILL.md skill
aiyo28/memento-os · adapters/codex/skills/memento-lint/SKILL.md · Validate every reasoning artifact in vault _context.md tables against schema rules. [D]/[I] need an invalidates clause…
v1.0.0 · audit A · 4 stars
session-complete SKILL.md skill
aiyo28/memento-os · adapters/codex/skills/session-complete/SKILL.md · Run at end of session OR before compaction. Extracts reasoning artifacts with priority matrix, updates NEXT.md, appends…
v4.2.0 · audit A · 4 stars
session-start SKILL.md skill
aiyo28/memento-os · adapters/codex/skills/session-start/SKILL.md · Session opening ritual. Loads context via L0→L1 protocol, displays briefing with active decisions and pending items…
v2.0.1 · audit A · 4 stars
vault-audit SKILL.md skill
aiyo28/memento-os · adapters/codex/skills/vault-audit/SKILL.md · Vault health check. Validates structure, detects stale reasoning artifacts by priority level, processes inbox, and…
v1.1.0 · audit A · 4 stars
llms.txt llms.txt file
aiyo28/memento-os · llms.txt
git:20260905.f7bc340 · audit A · 4 stars
memento:decide SKILL.md skill
aiyo28/memento-os · skills/decide/SKILL.md · Composable decision skill. Core OODA loop: present options, assess confidence, record reasoning artifact with priority…
v2.0.0 · audit A · 4 stars
memento:grill-me SKILL.md skill
aiyo28/memento-os · skills/grill-me/SKILL.md · Stress-test a plan, design, or architecture through relentless structured interviewing. Produces reasoning artifacts as…
v1.1.0 · audit A · 4 stars

Every file in aiyo28/memento-os

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