onboarding

Personalize COG for your workflow - creates profile, interests, and watchlist files with guided setup (run this first!)

Quality

—

Does it follow best practices?

Impact

—

No eval scenarios have been run

Securityby

Passed

No known issues

Quality

Content

77%

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

The skill is highly actionable with a clear, well-validated workflow, but it is a monolithic single-file skill whose large inline templates and conceptual padding bloat the token budget and miss progressive-disclosure opportunities.

Suggestions

Move the full WELCOME-TO-COG.md, MY-PROFILE.md, and related file templates into reference files under references/ and link to them one level deep from the body.

Trim or remove the Philosophy and 'Benefits of markdown storage' sections, which restate concepts Claude already knows.

Replace inline template blocks with concise field schemas plus a pointer to the template reference to cut token cost.

Dimension	Reasoning	Score
Conciseness	The body is mostly actionable but heavily padded with full inline file templates (notably the large WELCOME-TO-COG.md) and redundant Philosophy/markdown-benefit prose that could be tightened, matching the 'mostly efficient but could be tightened' anchor.	2 / 3
Actionability	Provides copy-paste-ready markdown templates with frontmatter, a concrete extraction table, exact directory structure, and verbatim prompt text, matching the fully executable/copy-paste-ready anchor.	3 / 3
Workflow Clarity	A clear 9-step sequence with explicit checkpoints ('Wait for confirmation', check for existing profile), error handling, and resume-from-last-step feedback loops matches the clear-sequence-with-validation anchor.	3 / 3
Progressive Disclosure	All content is inline in a single ~560-line SKILL.md with no bundle files or external references; large templates like the welcome guide are content that should be split into separate files, matching the 'content that should be separate is inline' anchor.	2 / 3
	Total	10 / 12 Passed

Description

67%

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 clearly conveys what the skill produces and occupies a distinct COG-specific niche, but it lacks explicit 'Use when...' trigger guidance and only offers a partial set of natural trigger terms.

Suggestions

Add an explicit 'Use when...' clause, e.g. 'Use when the user runs /onboarding, mentions onboarding, or wants to set up COG for the first time.'

Include more natural trigger terms users would say such as 'onboarding', 'set up COG', or 'update my profile'.

Reframe '(run this first!)' as an explicit trigger condition rather than an ordering hint.

Dimension	Reasoning	Score
Specificity	Lists multiple concrete deliverables - 'creates profile, interests, and watchlist files' with 'guided setup' - matching the anchor for several specific concrete actions.	3 / 3
Completeness	Clearly states what it does but the 'when' is only implied by '(run this first!)' rather than an explicit 'Use when...' trigger, which caps completeness at 2 per the guidelines.	2 / 3
Trigger Term Quality	Includes some relevant keywords ('personalize', 'setup') but lacks natural trigger phrases a user would say and misses common variations, matching the 'some relevant keywords but missing common variations' anchor.	2 / 3
Distinctiveness Conflict Risk	Scoped to 'Personalize COG for your workflow', a clear niche tied to COG onboarding that is unlikely to trigger for the wrong skill.	3 / 3
	Total	10 / 12 Passed

Validation

87%

Warnings & errors only

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

Criteria	Description	Result
skill_md_line_count	SKILL.md is long (560 lines); consider splitting into references/ and linking	Warning
frontmatter_unknown_keys	Unknown frontmatter key(s) found; consider removing or moving to metadata	Warning

	Total	14 / 16 Passed

Repository: huytieu/COG-second-brain
Commit: 5e9851c

Reviewed: 14 days ago

Table of Contents

Discovery Implementation Validation

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.