CtrlK
BlogDocsLog inGet started
Tessl Logo

outline

Search, read, and manage Outline wiki documents. Use when: (1) searching wiki for documentation, (2) reading wiki pages or articles, (3) listing wiki collections or documents, (4) creating or updating wiki content, (5) exporting documents as markdown. Works with any Outline wiki instance (self-hosted or cloud).

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

68%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-organized CLI skill document with fully concrete, verified command examples and clear supporting tables. The main weaknesses are missing post-write validation in the workflow for state-changing operations, setup instructions referencing two bundle files that don't exist, and command/env-var information duplicated between examples and tables.

Suggestions

Add a post-write verification step to the Workflow section (e.g., after create/update, re-run `read <document-id>` to confirm the content or publish state changed as expected), which would lift workflow_clarity above the validation cap.

Either ship requirements.txt and .env.example in the bundle or replace the Setup steps with instructions that work as-is (e.g., `pip install requests` and inline export of the two variables), so the documented commands execute without missing files.

Deduplicate the Operations Reference table against the Usage examples (and the Environment Variables table against Setup) — keep one canonical quick-reference location so roughly a third of the body isn't restated.

DimensionReasoningScore

Conciseness

No space is wasted explaining concepts Claude already knows — it goes straight to setup and command examples. However, content is duplicated: every command appears both as a bash example and again as a row in the "Operations Reference" table, and the env vars in the Setup section are restated in the "Environment Variables" table. This fits the 4 anchor ("efficient; minor instances... that could be trimmed") rather than 3, since the redundancy is deliberate cross-referencing, not padded explanation.

4 / 5

Actionability

Every one of the nine commands has a copy-paste-ready bash invocation with variants (e.g., `python3 scripts/outline.py read <document-id> --json`), and the commands verified against the actual argparse surface of scripts/outline.py. Minor gaps: Setup step 1 says `cp .env.example .env` and Requirements says `pip install -r requirements.txt`, but neither requirements.txt nor .env.example ships in the bundle, so those instructions fail as written. This is the 4 anchor ("mostly executable... minor gaps"), not 5.

4 / 5

Workflow Clarity

The Workflow section gives a clear sequence (auth-info → list-collections → search/list-documents → read → create/update) with one up-front validation checkpoint ("Run `auth-info` to verify connection"). But the write steps — `update --text` overwrites document content and `update --publish`/`--unpublish` change document state — have no post-write verification (e.g., re-reading the document to confirm the change). Per the rubric's cap for mutating operations without validation, this sits at the 3 anchor ("sequence present but checkpoints missing or implicit"), not 4.

3 / 5

Progressive Disclosure

The body is well-sectioned (Requirements, Setup, Usage, JSON Output, Operations Reference, Environment Variables, Troubleshooting, Exit Codes, Workflow) and its only bundle reference, `scripts/outline.py`, is a real file — no dead or nested references. At ~140 lines it inlines the complete CLI reference where a small operations reference file could carry the tables, keeping it at the 4 anchor ("good structure; most content appropriately placed; minor organization gaps") rather than 5.

4 / 5

Total

15

/

20

Passed

Description

92%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: concrete third-person action list up front, an explicit five-item "Use when" trigger clause, and consistent Outline-specific naming that keeps conflict risk low. The only minor gap is a couple of missing natural synonyms such as "knowledge base".

DimensionReasoningScore

Specificity

"Search, read, and manage Outline wiki documents" plus the enumerated list — "(1) searching wiki for documentation, (2) reading wiki pages or articles, (3) listing wiki collections or documents, (4) creating or updating wiki content, (5) exporting documents as markdown" — names multiple concrete actions (search, read, list, create, update, export-as-markdown) with comprehensive coverage of the tool's surface. Fits the 5 anchor ("multiple specific concrete actions; comprehensive coverage") rather than 4, since no meaningful capability is left unnamed.

5 / 5

Completeness

Both halves are explicit: the "what" opens the description ("Search, read, and manage Outline wiki documents") and the "when" is a concrete enumerated "Use when: (1)...(5)" clause. This matches the 5 anchor ("clearly and explicitly answers both what AND when with concrete trigger phrases") and exceeds the 4 anchor, where the "when" is present but less specific.

5 / 5

Trigger Term Quality

Natural user phrasings are present: "searching wiki for documentation", "reading wiki pages or articles", "wiki collections", "creating or updating wiki content", "exporting documents as markdown". A few natural synonyms are missing — e.g., "knowledge base" or "Outline docs" — so it sits between the 4 anchor ("good keyword coverage; a few natural terms missing") and the 5 anchor, landing at 4.

4 / 5

Distinctiveness Conflict Risk

The product is named consistently ("Outline wiki", "Outline wiki instance") and the triggers are Outline-specific ("wiki collections", "exporting documents as markdown", "self-hosted or cloud"), giving it a clear niche with minimal overlap against generic document or web-reading skills. Not 4, since even closely related skills (generic doc tools) would rarely claim these triggers.

5 / 5

Total

19

/

20

Passed

Validation

100%

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

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
sanjay3290/ai-skills
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.