ai-note SKILL.md skillA
ai-note from arcasilesgroup/ai-engineering is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.
mdr add arcasilesgroup/ai-engineering/ai-note@git:20260926.b0fd9cfPins git:20260926.b0fd9cf in mdr.lock. Pin the fingerprint instead.
- Audit grade
- A, 17 of 17 checks passed
- Kind
- SKILL.md skill
- Repository
- arcasilesgroup/ai-engineering
- Path
skills/ai-note/SKILL.md- Versions recorded
- 6
- Latest version
- git:20260926.b0fd9cf, committed Sep 26, 2026
- First version recorded
- Sep 1, 2026
- Size
- 6,489 bytes
- Repository stars
- 65
- License
- Apache-2.0
Saves a finding that took real time to reach — a non-obvious behaviour, an integration trap, a workaround and the reason it is needed — as committed markdown, stamped with the commit and the file patterns it describes so that it can be detected as stale later. Searches those notes too. Trigger for "save this", "note that", "remember this", "we worked this out the hard way", "do we have notes on", "what did we find about". Not for project decisions — use /ai-brainstorm, which is where a…
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
# ai-note — save what it cost you to find out
## What it produces
A block in the repository's `DECISIONS.md`. One decision, one `## D-NNN` block, with the sections below. Or, when the finding belongs in the docs, prose handed to ai-write. This skill creates no file of its own.
## Steps
1. The bar is thirty minutes. If it took less than that to work out, it will take less than
that again, and a note about it is noise that hides the ones that matter.
2. Append one block. Do not rewrite an older block. The heading is the id the git floor counts:
```markdown
## D-NNN: <what we do, in one line>
Status: Accepted · Date: YYYY-MM-DD
### Context
What forced the choice. Include `found`, `commit`, the files it describes, and `still_true_when`, so a later reader can tell if it rotted.
### Decision
What we do, specific enough to check in the code.
### Consequences
- What this makes easy
- What this rules out
### Alternatives considered
- **<Option>:** why not
```
3. The Decision is the value. Context is why anybody will believe it.
4. Point at the evidence. The command you ran, its output, the line in the vendor's source.
…Read the whole file at its exact version.
How to install
mdr add arcasilesgroup/ai-engineering/ai-note@sha256:ce9bbc7177e4f66cThe line at the top of this page pins the label git:20260926.b0fd9cf, 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_gtijz3zyg4oikwqk)
5 badge image fetches in 30 days. What the badge shows.
Versions
The registry has recorded 6 versions of this file, between Sep 1, 2026 and Sep 26, 2026, about one every 5 days.
| version | committed | commit | size | audit | |
|---|---|---|---|---|---|
| git:20260926.b0fd9cf latest | 2026-09-26 | b0fd9cf | 6,489 B | A | view · diff |
| git:20260922.83b942f | 2026-09-22 | 83b942f | 6,412 B | A | view · diff |
| git:20260914.793714f | 2026-09-14 | 793714f | 6,418 B | A | view · diff |
| git:20260910.d021330 | 2026-09-10 | d021330 | 6,422 B | A | view · diff |
| git:20260901.deb68d3 | 2026-09-01 | deb68d3 | 6,258 B | A | view · diff |
| git:20260901.dca22e5 | 2026-09-01 | dca22e5 | 1,828 B | A | view |
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 (6489 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
arcasilesgroup/ai-engineering · 65 stars · license Apache-2.0 · pushed 2026-11-09 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_gtijz3zyg4oikwqk GET https://markdownregistry.com/api/v1/resolve?ref=arcasilesgroup/ai-engineering/ai-note GET https://markdownregistry.com/api/v1/blob/ce9bbc7177e4f66cbf13cc5e270631c552db5c99c31d3168da9412986511fc62
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.