CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

audit

Use when the user asks to audit a memex (long-term knowledge bank for AI agents) for orphans, dead SALP REFs, missing sections, contradictions or index drift. Runs a structural check, layers LLM-judgement findings, auto-fixes trivia with `--fix`.

67

Quality

84%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

76%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

Highly actionable and well-organized: exact commands, templates, and a verified bundled script make the skill immediately executable. The main gap is the missing post-fix verification loop for the batch `--fix` path, which caps workflow clarity; minor duplication of the frontmatter description in the body's intro and 'When to invoke' sections could also be trimmed.

Suggestions

Add a post-fix verification step: after applying `--fix` auto-fixes, re-run `scripts/audit.ts <memex-root>/pages/` and confirm DEAD_LINK / INDEX_MISSING / INDEX_DEAD issues are resolved before writing the report (a validate-fix-retry feedback loop for the batch write path).

Trim the duplicated trigger guidance — the intro paragraph and 'When to invoke' section restate the frontmatter description; keep one concise line or drop the section.

Consider moving the per-issue output-format documentation and the report template into a small references/ file to keep SKILL.md as a lean overview.

DimensionReasoningScore

Conciseness

The body is dense and operational — exact commands, exact issue-line formats, a fix decision table, and templates with no padding or explanation of known concepts. It falls short of anchor 5 because the intro paragraph restates the frontmatter description and the 'When to invoke' section duplicates that trigger guidance again; the install-path parenthetical is also longer than needed. Not anchor 3 — there is no unnecessary explanation to speak of.

4 / 5

Actionability

Everything is copy-paste ready: 'deno run --allow-read scripts/audit.ts <memex-root>/pages/', 'grep -rln "\[!WARNING\]" <memex-root>/pages/', exact per-issue output formats, an exact stub-page template, and full report and log.md templates. The bundled script exists and behaves as documented. Matches anchor 5.

5 / 5

Workflow Clarity

Six clearly numbered steps in a coherent sequence with severity classification, a constraints checklist, and safe default behavior. However, the `--fix` path is a batch write operation (stub creation, index.md edits, section appends) with no post-fix verification checkpoint — e.g., no instruction to re-run scripts/audit.ts to confirm DEAD_LINK/INDEX issues are resolved. Per the rubric, batch operations without validation cap workflow clarity at 3; the cap applies here. Not 2 — the sequence itself is thorough with explicit checklists.

3 / 5

Progressive Disclosure

A single well-sectioned SKILL.md with one bundled script (scripts/audit.ts) referenced by exact path and verified to exist and match its documented behavior. Structure is good and navigation is easy. Not anchor 5 — the issue-kind documentation and full report template sit inline, making the body denser than a pure overview with split-out detail; not anchor 3 — references that exist are clearly signaled and content is appropriately placed for a ~110-line skill.

4 / 5

Total

16

/

20

Passed

Description

87%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong description with an explicit 'Use when...' trigger, a distinct niche vocabulary, and a solid enumeration of what the skill does. The only weakness is that the action verbs ('structural check', 'LLM-judgement findings') are slightly umbrella and a few natural synonyms ('health check', 'dead links') are missing.

DimensionReasoningScore

Specificity

Names the domain (memex audit) and several concrete actions ('Runs a structural check, layers LLM-judgement findings, auto-fixes trivia with `--fix`') plus enumerated issue types ('orphans, dead SALP REFs, missing sections, contradictions or index drift'). It falls short of anchor 5 because 'structural check' and 'LLM-judgement findings' are umbrella labels rather than fully concrete actions, but it clearly exceeds anchor 3's 1-2 actions.

4 / 5

Completeness

Explicitly answers both: 'what' via 'Runs a structural check, layers LLM-judgement findings, auto-fixes trivia with `--fix`' and 'when' via the concrete trigger phrase 'Use when the user asks to audit a memex... for orphans, dead SALP REFs, missing sections, contradictions or index drift'. This matches the anchor-5 example pattern exactly.

5 / 5

Trigger Term Quality

'Use when the user asks to audit a memex' plus 'orphans', 'contradictions', 'dead SALP REFs' give good natural keyword coverage — a user would plausibly say 'audit my memex'. Not anchor 5 because common synonyms like 'health check' or 'dead links' are absent; not anchor 3 because the core natural terms are present and specific.

4 / 5

Distinctiveness Conflict Risk

'memex (long-term knowledge bank for AI agents)' and 'SALP REFs' define a clear niche with distinct trigger terms ('audit a memex', 'index drift') that no generic skill would claim. Minimal conflict risk, matching anchor 5.

5 / 5

Total

18

/

20

Passed

Validation

93%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository

korchasa/flowai-plugins

Path

plugins/flowai-memex/skills/audit/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.