add-domain

Add a new knowledge domain to your existing system. Derives domain-specific configuration through conversation, generates domain folders, templates, and vocabulary while preserving and connecting to your existing architecture.

Quality

71%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Low

Low-risk findings worth noting

Fix and improve this skill with Tessl

tessl review fix ./skills/add-domain/SKILL.md

Quality

Content

85%

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-structured, highly actionable multi-phase workflow with strong validation feedback loops and good reference hygiene; its only weakness is moderate verbosity in explanatory prose and rationale columns.

Dimension	Reasoning	Score
Conciseness	The body is mostly efficient procedural guidance, but ~430 lines include context-setting prose and 'Rationale' table columns that re-state reasoning Claude could infer, so it could be tightened.	2 / 3
Actionability	Provides concrete, executable guidance throughout: real bash commands (mkdir, find/uniq -d, qmd), YAML schema blocks, and markdown templates the model can fill and emit directly.	3 / 3
Workflow Clarity	Seven numbered phases are clearly sequenced with explicit validation checkpoints (collision check, coherence check, kernel validation) and a user-approval feedback loop before generation.	3 / 3
Progressive Disclosure	A dedicated Reference Files section lists one-level-deep references each with a short purpose annotation, and detailed presets/transforms are offloaded to those files; the inline content is the workflow itself.	3 / 3
	Total	11 / 12 Passed

Description

57%

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 the skill's purpose and concrete actions, but uses second-person voice and omits an explicit 'Use when' trigger clause, leaving it just short of fully complete.

Suggestions

Rewrite in third person ('Adds a new knowledge domain...') to remove the second-person voice and recover the specificity score.

Append an explicit trigger clause, e.g. 'Use when adding a new knowledge domain or extending an existing notes/knowledge system with a second domain.'

Broaden trigger-term coverage with natural variations users might say (e.g. 'second domain', 'add a domain', 'extend my notes system').

Dimension	Reasoning	Score
Specificity	Lists multiple concrete actions ('Derives domain-specific configuration through conversation, generates domain folders, templates, and vocabulary'), which would anchor at 3, but the second-person phrasing ('your existing system', 'your existing architecture') triggers the voice penalty, reducing it by one level.	2 / 3
Completeness	The 'what' is clearly stated, but there is no 'Use when...' clause or equivalent explicit trigger guidance, which caps completeness at 2 per the rubric.	2 / 3
Trigger Term Quality	Relevant natural terms are present ('new knowledge domain', 'domain folders, templates, vocabulary') but coverage is thin with few common variations and no explicit trigger phrasing a user would echo.	2 / 3
Distinctiveness Conflict Risk	The niche is clear and specific to extending an existing knowledge system with a new domain, making it unlikely to trigger for the wrong skill.	3 / 3
	Total	9 / 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
allowed_tools_field	'allowed-tools' contains unusual tool name(s)	Warning
frontmatter_unknown_keys	Unknown frontmatter key(s) found; consider removing or moving to metadata	Warning

	Total	14 / 16 Passed

Repository: agenticnotetaking/arscontexta
Path: skills/add-domain/SKILL.md
Commit: 2acfd5c

Reviewed: 3 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.