From flowai-memex
Use when the user asks to audit a memex (long-term knowledge bank for AI agents) for orphans, dead wikilinks, missing sections, contradictions, or index drift. Runs a deterministic structural check, layers LLM-judgement findings, optionally auto-fixes trivial issues with `--fix`. Do NOT trigger on general code linting.
How this skill is triggered — by the user, by Claude, or both
Slash command
/flowai-memex:memex-audit [--fix][--fix]The summary Claude sees in its skill listing — used to decide when to auto-load this skill
Health check for the memex (long-term knowledge bank for AI agents). Runs a deterministic script first, then layers LLM-judgement checks on top.
Health check for the memex (long-term knowledge bank for AI agents). Runs a deterministic script first, then layers LLM-judgement checks on top.
Invoked when the user wants a memex health check (e.g., "audit my memex", "check the memex for dead links", /flowai-memex:memex-audit for audit-only or /flowai-memex:memex-audit --fix to apply trivial auto-fixes).
Same protocol as the other memex skills:
--memex <path> flag → use that path.AGENTS.md and pages/.No memex found. Pass --memex <path> or cd into a memex directory.Read <memex-root>/AGENTS.md for the schema.
Run the audit script bundled with this skill:
deno run --allow-read scripts/flowai-memex-audit.ts <memex-root>/pages/
(The path is relative to the installed skill directory. The exact location depends on the IDE — pass an absolute path if your IDE does not preserve relative working directory.)
The script reports four issue kinds, one per line:
DEAD_LINK: [[target]] in <file> — wikilink points to a non-existent page.ORPHAN: <file> has no inbound [[links]] — page is not linked from anywhere except itself.MISSING_SECTION: <file> (concept) lacks 'Counter-Arguments and Gaps' — concept page missing the gaps section.INDEX_MISSING: <file> not listed in index.md / INDEX_DEAD: index.md references [[slug]] which has no file — drift between filesystem and pages/index.md.The script handles structure. The following require reading content:
grep -rln "\[!WARNING\]" <memex-root>/pages/ to find every callout marker. List them — these need human resolution.date older than 6 months. Flag any whose claims are likely outdated (rapidly-changing fields).[[wikilink]] even though a corresponding page exists. Add the wikilink at the first natural mention if --fix, else just suggest.index.md and identify domains with only 1–2 pages. Suggest 3–5 questions the memex cannot yet answer well — candidates for flowai-memex-ask or further flowai-memex-save.--fix)For each issue with a trivial deterministic fix, apply it:
| Issue | Auto-Fix |
|---|---|
DEAD_LINK | Create stub page at the link target with the closest matching template (default: concept). Stub body: # <Slug as Title>\n\n_Stub created by audit. Needs content from a source._\n\n## See Also\n- [[<page that linked to it>]]. |
MISSING_SECTION | Append empty ## Counter-Arguments and Gaps\n\n_None recorded yet._ to the concept page. |
INDEX_MISSING | Add the page to index.md under a domain derived from its tags frontmatter. |
INDEX_DEAD | Remove the dead row from index.md. |
ORPHAN | NOT auto-fixed — finding a sensible inbound page requires judgement. List it for the user. |
[!WARNING] contradiction | NOT auto-fixed — surface for human review. |
| Stale-claim suspicion | NOT auto-fixed — surface for human review. |
| Unlinked concept mention | Add [[wikilink]] at the first natural mention only when --fix is set AND the target page exists. Otherwise just suggest. |
Write <memex-root>/outputs/reports/YYYY-MM-DD-audit.md (create outputs/reports/ if missing):
# Memex Audit Report — YYYY-MM-DD
**Memex:** <memex-root> | **Issues:** N | **Auto-fixed:** M
## Critical
- DEAD_LINK: ... (auto-fixed: stub created at <path>)
- ...
## Warnings
- ORPHAN: ... — suggest linking from <candidate>
- ...
## Suggestions
- 3–5 questions the memex cannot yet answer:
1. ...
2. ...
## Contradictions
- <file>:<line>: <one-line summary> — needs human resolution
log.md## [YYYY-MM-DD] audit | <total> issues, <fixed> auto-fixed
<one-line summary of the worst class of issue>
Print a compact summary:
outputs/reports/.INDEX_DEAD removes index rows, but the underlying file (if it exists) stays.Read, Glob, Grep, Bash (for the deterministic script and for grep), Edit (for index.md, log.md, and append-only fixes), Write (for stub pages and the audit report).--fix, the audit skill is read-only on the memex except for the report file and log.md.npx claudepluginhub korchasa/flowai-plugins --plugin flowai-memexProvides UI/UX resources: 50+ styles, color palettes, font pairings, guidelines, charts for web/mobile across React, Next.js, Vue, Svelte, Tailwind, React Native, Flutter. Aids planning, building, reviewing interfaces.
Fetches up-to-date documentation from Context7 for libraries and frameworks like React, Next.js, Prisma. Use for setup questions, API references, and code examples.