Getting it into your agent
One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.
npx skills add solentlabs/ai-journal-mcp --skill maintaingit clone --depth 1 https://github.com/solentlabs/ai-journal-mcpWrote this? Show the measurements
A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.
[](https://agentmods.dev/skills/solentlabs/ai-journal-mcp/maintain)<a href="https://agentmods.dev/skills/solentlabs/ai-journal-mcp/maintain"><img src="https://agentmods.dev/badge/skills/solentlabs/ai-journal-mcp/maintain/github.svg" alt="Measured on agentmods" height="20"></a>Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.
<a href="https://agentmods.dev/skills/solentlabs/ai-journal-mcp/maintain"><img src="https://agentmods.dev/badge/skills/solentlabs/ai-journal-mcp/maintain.svg" alt="Reviewed on agentmods" width="80" height="20"></a>What it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5.1 | $0.00070 | $0.00431 |
| Opus 5.5 | $0.00028 | $0.00172 |
| Sonnet 5.5 | $0.00014 | $0.00086 |
| Haiku 4.5 | $0.00007 | $0.00043 |
Grade A, and why
maintain scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 1mo ago.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Nothing flagged
None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.
What it actually says
ai-journal-mcp — Maintain
Markdown is the source of truth; the search index and the generated views are disposable and rebuilt from it. This skill keeps them in sync and surfaces drift.
When to use
- You hand-edited or bulk-moved entry files (outside
add_entry). - Search results look stale or incomplete.
- A periodic health check on a journal.
What to do
- Rebuild the index. The
reindexMCP tool rebuilds search from the markdown sources. (CLI:ai-journal-mcp reindex <paths...> --db <path>.) The index is disposable — rebuild anytime, it changes no source data. - Regenerate views. For a managed journal,
ai-journal-mcp refresh <root>regeneratesJOURNAL.mdandthemes/. It also rescues any dated entry a stale session appended directly toJOURNAL.md— saving it as a real entry before regenerating, so no text is lost. - Check health.
list_themesandentries_over_time(MCP) show the shape and spot gaps such as(unthemed)entries.ai-journal-mcp scan <root>(CLI) reports orphan files with no dated entries and duplicate groups.
Principles
- Index and views are derived; markdown wins. Rebuild freely.
- Generated views (
JOURNAL.md,themes/*.md) are never hand-edited — edits go in the entry files, then regenerate. indexed-mode journals are read-only; maintenance never rewrites them.
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- 1mo ago First seen · 37 lines · 70 tokens per session scan A cccd67c3059c
maintain is a skill published in the GitHub repository solentlabs/ai-journal-mcp (1 stars, last pushed 2mo ago), licensed MIT. It adds 70 tokens to every session and 431 once invoked, about $0.0003 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.
Other skills, from other repositories
digest
Write one page about an article, blog post, news item, release note, or talk (slides) from its URL into this Scraps wiki, without dialogue - a short summary of what the source says, linked to the pages the wiki already has. Use this when the user hands over the URL of something they read or want to keep up with and…
learn
Learn a source together with the user and record only what they understood as a new page in this Scraps wiki. Explains the source with a diagram anchored on the pages the wiki already has, checks comprehension with questions, then writes one page from the points that passed; when understanding is not reached, nothing…
ingest
Create a new scrap from a source (prompt, URL, or arbitrary markdown), update cross-links in related scraps, and run a sanity check. Use this when the user wants to add a scrap, summarize an article, save synthesized content to the wiki, or file back a Q&A result.
query
Answer questions about the wiki by searching, reading, and synthesizing relevant scraps with [[Title]] citations. Use this when the user wants to query the wiki, ask what they have written about a topic, compare scraps, find related notes, or pull a synthesized overview from existing scraps.
mikke
A command-line search tool for finding information in a folder of Markdown notes. It can search exact words, titles, tags, and broader meanings in past notes.
planning-with-scratchpad
Use when user explicitly requests planning with a scratchpad, or asks for persistent tracking of a complex task that the human can browse visually. Backs planning files with the scratch CLI so a pad's files are registered and viewable.