CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

ask

Use when the user asks a question to be answered from the project's memex (long-term knowledge bank for AI agents) rather than training data or the live web. Reads the index, follows one SALP-REF hop, files a cited answer back. Not for source code.

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

82%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.

A well-crafted procedural skill: every step has concrete paths, templates, and explicit fallbacks, and constraints are unambiguous. The dated incident annotation in the Honest-Gaps section and the absence of a final consistency verification after filing are the only notable weaknesses.

Suggestions

Move the '(2026-09-06: ask-honest-gap...)' dated incident note into a 'Notes' or deprecation-style section (or trim it) — time-sensitive detail inline penalizes token efficiency.

Add a brief final verification after step 7 (e.g. confirm the answer file exists, anchor and Sources section are present, and log entry matches) to close the validation gap in the workflow.

Consider splitting the promotion procedure (step 6) into a short one-level-deep reference file to reduce main-file length.

DimensionReasoningScore

Conciseness

Lean and imperative throughout — exact paths, templates, and formats with almost no explanation of concepts Claude already knows. Not 5: the dated incident parenthetical ('(2026-09-06: ask-honest-gap withheld the answer...)') and some repetition of the no-training-data-fallback rule across sections could be trimmed; per the guidelines, the specific date penalizes unless placed in a deprecation/notes section.

4 / 5

Actionability

Fully executable guidance: exact resolution order for the memex root, exact index path and Glob fallback, concrete citation examples with real REF syntax, exact answer-page frontmatter, slug derivation rules with an example, collision handling ('append -2, -3'), exact user prompt text for promotion, and exact log.md entry templates. Copy-paste ready for the common cases.

5 / 5

Workflow Clarity

Eight clearly numbered steps with explicit error-recovery paths (no memex found → stop message; missing index.md → Glob fallback; gaps → status: gap filing; slug collision → -2 suffix) and guardrails (never overwrite, read-only on raw/). Not 5: there is no final verification checkpoint confirming the filed answer, log, and index entries are consistent (e.g. running/mentioning the audit script is only suggested in one fallback branch), a minor validation gap.

4 / 5

Progressive Disclosure

No bundle files exist and none are referenced, so the skill is scored as self-contained: well-organized sections ('Memex Resolution', numbered 'Ask Steps', 'Honest-Gaps Rule', 'Constraints') covering a single coherent procedure. Not 5: at ~127 lines it exceeds the under-50-lines simple-skill exception, and a few cohesive chunks (the promotion procedure, the honest-gap filing details) could plausibly live in a one-level-deep reference file to slim the main file.

4 / 5

Total

17

/

20

Passed

Description

80%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: explicit 'Use when' trigger, concrete third-person action list, and clear boundaries against adjacent skills. The main gap is trigger-term breadth — natural user phrasings like 'look this up in my notes' or 'search my knowledge base' are absent, and 'SALP-REF' is undefined jargon in the description itself.

Suggestions

Add natural trigger synonyms users would actually say, e.g. 'look this up in my memex/notes', 'search my knowledge base', alongside 'asks a question'.

Briefly gloss 'SALP-REF' (e.g. 'internal citation links') so the description's action list is self-contained for a reader who hasn't seen the body.

DimensionReasoningScore

Specificity

Quotes several concrete actions in third person — 'Reads the index, follows one SALP-REF hop, files a cited answer back' — plus a boundary ('Not for source code'). Not 5: 'SALP-REF hop' is project jargon whose meaning is only implicit here, and capabilities like citation format and honest-gap reporting are only partially covered. Not 3: it lists multiple specific actions, not just 1-2.

4 / 5

Completeness

Explicitly answers both: what ('Reads the index, follows one SALP-REF hop, files a cited answer back') and when ('Use when the user asks a question to be answered from the project's memex... rather than training data or the live web'), with a concrete negative boundary ('Not for source code'). Clearly matches the anchor-5 example's structure of capability list + explicit 'Use when' clause.

5 / 5

Trigger Term Quality

Relevant keywords present — 'asks a question', 'memex', 'training data', 'the live web' — but common natural variations users would say are missing: 'look this up in my notes', 'search my knowledge base', 'ask the memex' (the latter appears in the body, not the description). Not 4: the missing variations are ones users would plausibly say, not just a few.

3 / 5

Distinctiveness Conflict Risk

Clear niche ('project's memex (long-term knowledge bank for AI agents)') with distinct triggers and an explicit exclusion ('Not for source code', 'rather than training data or the live web') that separates it from general Q&A, web search, and code skills. Minimal conflict risk.

5 / 5

Total

17

/

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/ask/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.