CtrlK
BlogDocsLog inGet started
Tessl Logo

digital-brain

This skill should be used when the user asks to "write a post", "check my voice", "look up contact", "prepare for meeting", "weekly review", "track goals", or mentions personal brand, content creation, network management, or voice consistency.

57

1.38x
Quality

36%

Does it follow best practices?

Impact

98%

1.38x

Average score across 3 eval scenarios

SecuritybySnyk

Advisory

Suggest reviewing before use

Optimize this skill with Tessl

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

Quality

Discovery

29%

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

This description is essentially a list of trigger phrases with no explanation of what the skill actually does. While it excels at providing natural keywords users might say, it completely fails to describe concrete capabilities, making it impossible for Claude to understand what actions this skill performs. The extremely broad scope covering 6+ distinct domains creates high conflict risk with other skills.

Suggestions

Add a clear 'what it does' section listing specific concrete actions (e.g., 'Drafts social media posts matching the user's established voice, manages a contact database, generates meeting prep briefs, and tracks weekly goals').

Consider whether this should be split into multiple focused skills (e.g., content creation, contact management, meeting prep) to reduce conflict risk with other skills.

Restructure to lead with capabilities first, then follow with 'Use when...' trigger guidance, following the pattern: '[What it does]. Use when [triggers].'

DimensionReasoningScore

Specificity

The description lists trigger phrases but never describes what the skill actually does. There are no concrete actions like 'writes blog posts', 'analyzes tone', or 'manages contacts' — only vague references to domains like 'personal brand', 'content creation', 'network management'.

1 / 3

Completeness

The 'when' is thoroughly covered with explicit trigger phrases, but the 'what' — what the skill actually does — is entirely missing. There is no explanation of capabilities, outputs, or concrete actions the skill performs.

1 / 3

Trigger Term Quality

The description includes many natural trigger phrases users would actually say: 'write a post', 'check my voice', 'look up contact', 'prepare for meeting', 'weekly review', 'track goals', plus broader terms like 'personal brand' and 'content creation'.

3 / 3

Distinctiveness Conflict Risk

The skill covers an extremely broad range of unrelated domains — content writing, voice analysis, contact lookup, meeting prep, weekly reviews, and goal tracking. This breadth makes it highly likely to conflict with more specialized skills in any of these areas.

1 / 3

Total

6

/

12

Passed

Implementation

42%

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

The skill has strong organizational structure and progressive disclosure, effectively serving as a routing document to deeper module files. However, it suffers from significant verbosity—explaining file formats, data patterns, and architectural concepts that Claude already understands—and lacks concrete executable examples and validation checkpoints in its workflows. The content would benefit greatly from trimming explanatory sections and adding actual code/command examples with verification steps.

Suggestions

Remove the 'Core Concepts' section explaining file formats, progressive disclosure architecture, and append-only semantics—Claude already knows these. Replace with a brief one-liner like 'All data files are JSONL (append-only), YAML (config), or Markdown (narrative).'

Convert workflow steps from prose descriptions into executable commands or tool calls (e.g., show the actual JSONL append command, the exact file read pattern, or a concrete code snippet for logging a post).

Add validation checkpoints to workflows—e.g., after appending to JSONL, verify the entry was written correctly; after reading voice.md, confirm key voice attributes were extracted before drafting.

Remove the 'Integration' and 'Skill Metadata' sections entirely—they add no actionable guidance and waste token budget.

DimensionReasoningScore

Conciseness

Significant verbosity throughout. Explains concepts Claude already knows (what JSONL is, what YAML is, what append-only means, what progressive disclosure is). The 'Core Concepts' section with the file format strategy table and progressive disclosure architecture explanation are unnecessary padding. The 'Integration' section explaining context engineering principles adds no actionable value. The skill metadata at the bottom wastes tokens.

1 / 3

Actionability

Workflows are listed with numbered steps and specific file paths, which is helpful. However, the steps are described in plain text rather than executable commands (e.g., 'Read identity/voice.md' is a direction, not a concrete action with expected output). The code blocks for workflows are formatted as code but contain prose instructions, not executable commands. The weekly review references Python scripts but doesn't show their usage beyond the command name.

2 / 3

Workflow Clarity

Multi-step processes are clearly sequenced (content creation, pre-meeting, weekly review) with numbered steps. However, there are no validation checkpoints or error recovery steps. For operations involving appending to JSONL files and modifying data, there's no verification that writes succeeded or that data integrity was maintained, despite the emphasis on append-only data integrity.

2 / 3

Progressive Disclosure

Excellent progressive disclosure structure. The SKILL.md serves as a clear overview with well-signaled one-level-deep references to module-specific docs (identity/IDENTITY.md, content/CONTENT.md, etc.). The three-level loading pattern is explicitly defined, and the 'When to Activate' section clearly maps tasks to which modules to load first.

3 / 3

Total

8

/

12

Passed

Validation

90%

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

Validation10 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

Total

10

/

11

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.