CtrlK
BlogDocsLog inGet started
Tessl Logo

digital-brain

This skill should be used for personal operating-system workflows: content creation, voice consistency, relationship lookup, meeting preparation, weekly review, goal tracking, personal brand management, and network management.

51

Quality

64%

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

Fix and improve this skill with Tessl

tessl review fix ./examples/digital-brain-skill/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

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

The body is a well-organized, mostly lean overview with concrete file paths, runnable commands, and worked examples for its main workflows. Its weaknesses are the complete absence of validation/verification checkpoints in the workflows and a progressive-disclosure layer that points at module files missing from the bundle while leaving the existing references/file-formats.md orphaned and unlinked.

Suggestions

Add verification checkpoints to each workflow, e.g., after drafting content: "Verify the draft against voice.md attributes (tone, vocabulary, patterns) before presenting"; after running weekly_review.py: "Check the script's output for errors before updating goals.yaml".

Fix the reference layer: link references/file-formats.md from SKILL.md (e.g., under File Format Strategy: "Schemas for every data file: see [file-formats.md](references/file-formats.md)"), and remove or repair the broken links to identity/IDENTITY.md, content/CONTENT.md, network/NETWORK.md, operations/OPERATIONS.md, and agents/AGENTS.md, which do not exist in the bundle.

Trim the "Integration" section and the "Skill Metadata" block — design-philosophy name-dropping and authorship dates add tokens without improving execution.

DimensionReasoningScore

Conciseness

The body is dominated by lean tables, terse module listings, and short numbered workflows (e.g., the L1/L2/L3 loading table, the pipeline `ideas.jsonl` → `drafts/` → `posts.jsonl`), and it mostly assumes Claude's competence. A couple of sections are trimmable — the "Integration" section's context-engineering meta-commentary and the "Skill Metadata" block (created/author dates) add no execution value. This fits anchor 4 (efficient with minor over-explanation) rather than anchor 5, and it is well above anchor 3's 'several unnecessary explanations'.

4 / 5

Actionability

Guidance is mostly executable: specific file paths ("Read `identity/voice.md`", "Search `network/contacts.jsonl` for 'Sarah Chen'"), a runnable command ("Run: python agents/scripts/weekly_review.py"), and worked examples with Input/Process/Output. It falls short of anchor 5 because no entry schemas or append examples are shown inline (the schema conventions live in references/file-formats.md but are never linked), and some steps remain directional ("Draft matching voice attributes"). It is above anchor 3 because the paths and commands are concrete rather than pseudocode.

4 / 5

Workflow Clarity

Multi-step processes (content creation, pre-meeting prep, weekly review) are clearly numbered and well-sequenced, but there are no validation or verification checkpoints anywhere — e.g., no step to check a draft against voice attributes, no confirmation the weekly-review script succeeded before acting on its output. That matches anchor 3 (sequence present, checkpoints missing or implicit); anchor 4 requires most checkpoints present. The append-only rule mitigates destructiveness, so the batch-operation cap at 3 is consistent rather than the deciding factor.

3 / 5

Progressive Disclosure

Structure is good in intent — a three-level loading table, module map, and a clearly labeled one-level-deep References section — but scored against the actual bundle, every internal reference (./identity/IDENTITY.md, ./content/CONTENT.md, ./network/NETWORK.md, ./operations/OPERATIONS.md, ./agents/AGENTS.md) does not exist in the bundle, and the one real reference file (references/file-formats.md) is never linked from SKILL.md. Anchor 3 (structure present but with real organization gaps) fits; anchor 4 requires references that are mostly clear and resolvable.

3 / 5

Total

14

/

20

Passed

Description

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

The description names a coherent personal-OS domain and enumerates its workflow areas, but it reads as a category list rather than a capability statement: no concrete actions, no explicit 'Use when...' trigger clause, and about half the terms are jargon users would not naturally say. It is clearly distinguishable from 'helps with documents' vagueness but sits at the midpoint on all rubric dimensions.

Suggestions

State concrete actions first, e.g., "Drafts posts in the user's authentic voice, looks up contacts and interaction history, and runs weekly reviews against a personal knowledge base" — verbs with objects rather than workflow category nouns.

Add an explicit trigger clause: "Use when the user asks to write posts or content in their voice, look up a contact ('who is [name]'), prepare for a meeting, do a weekly review, or check on goals" — pulling the natural trigger phrases already listed in the body into the description.

Replace jargon labels users would not say ("personal operating-system workflows", "voice consistency") with conversational synonyms ("my voice", "my writing style", "contacts", "prep for my meeting").

DimensionReasoningScore

Specificity

The description lists eight named workflow areas ("content creation, voice consistency, relationship lookup, meeting preparation, weekly review, goal tracking, personal brand management, and network management") but these are domain categories rather than concrete actions — it never states what the skill actually does (e.g., "drafts posts in the user's voice", "looks up contacts in network/contacts.jsonl"). This matches anchor 3 (domain plus some concrete items, not comprehensive) better than anchor 4, which requires several specific actions, and better than anchor 2, which would cover only minimal or generic actions.

3 / 5

Completeness

The single sentence "This skill should be used for personal operating-system workflows: ..." merges a weak 'when' (use during these workflows) with a circular 'what' (the workflows themselves) and never states what the skill does with them. Per the guideline that a missing or weak 'Use when...' clause caps completeness at 3, this fits anchor 3; it is not anchor 4 because neither 'what' nor 'when' is independently clear and explicit, and not anchor 2 because trigger guidance is at least present and the domain is named.

3 / 5

Trigger Term Quality

Phrases like "weekly review", "meeting preparation", and "goal tracking" are natural user language, but "personal operating-system workflows", "voice consistency", and "network management" are jargon users would rarely say — a user would say "write a post in my voice" or "who is Sarah". Some relevant keywords exist but common conversational variations and synonyms are missing, which is anchor 3; anchor 4 would require only a few natural terms missing, but roughly half the terms here are formal category labels.

3 / 5

Distinctiveness Conflict Risk

The bundled personal-OS niche is somewhat distinctive, but individual triggers like "content creation", "meeting preparation", and "goal tracking" broadly overlap with general writing, productivity, and note-taking skills, so it could trigger for the wrong skill. This matches anchor 3 (somewhat specific, still overlaps with similar skills) — not anchor 4, which requires only minor overlap with closely related skills.

3 / 5

Total

12

/

20

Passed

Validation

87%

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

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

relative_links

Relative link issues: 5 missing

Warning

Total

14

/

16

Passed

Repository
muratcankoylan/Agent-Skills-for-Context-Engineering
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.