CtrlK
BlogDocsLog inGet started
Tessl Logo

aps-doc-id-unification

Expert documentation generation for ID unification layers. Documents identity resolution algorithms, merge strategies, match rules, entity graphs, and multi-workflow orchestration. Use when documenting ID unification processes.

50

Quality

54%

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 ./aps-doc-skills/id-unification/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

38%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 skill defines a clear specialized task and a usable workflow skeleton with codebase-access guardrails, but its body is dominated by ~200 lines of placeholder template scaffolding that pads tokens without executable instruction. Splitting templates into reference files and replacing placeholders with concrete extraction guidance would substantially improve it.

Suggestions

Move the four workflow template skeletons into a reference file (e.g., references/template.md) and keep SKILL.md as a concise overview that links to it.

Replace '{placeholder}' section bodies with concrete, actionable extraction instructions or a worked example rather than empty braces.

Add an explicit validate->fix->retry feedback loop for the multi-workflow documentation pass, since it is a batch operation spanning 4 child pages.

DimensionReasoningScore

Conciseness

The body inlines ~200 lines of near-empty markdown template skeletons with repeated placeholder sections ('{Purpose and business value}', '{What it does, business meaning, what gets created, processing time}') that add bulk without instruction. It is noticeably verbose with padded template scaffolding rather than lean guidance; it is not a 3 because the volume of redundant skeleton content goes beyond 'some unnecessary explanation'.

2 / 5

Actionability

It gives concrete structure (the parent/child page template, named workflows like unif_runner.dig, and required extraction targets), but the actual per-section bodies are placeholders ('{Real structure with keys, tables...}') rather than executable guidance or worked examples. This matches the score-3 anchor of 'some concrete guidance but incomplete'; it is not a 4 because the instruction bodies are skeletal rather than executable.

3 / 5

Workflow Clarity

There is a rough sequence (ask for codebase path -> verify files with Glob -> STOP if unreadable -> extract real data -> document all 4 workflows), with explicit STOP/validation checkpoints around codebase access. However the validation guidance is limited to input checks and lacks feedback loops for the destructive/batch documentation task, capping clarity at 3 per the rubric's batch-operation note.

3 / 5

Progressive Disclosure

No bundle files exist (references/, scripts/, assets/ are empty) and the four full template skeletons are inlined as a monolithic block rather than split into separate template files, with no navigation to deeper material. It is minimal structure with inlined content that clearly belongs in separate files; not a 3 because there are no references at all and the bulk is one undifferentiated inline block.

2 / 5

Total

10

/

20

Passed

Description

70%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 covers a clear, specialized niche with good keyword coverage and an explicit 'Use when' clause. Its main weaknesses are that the 'when' trigger is generic, and the domain keywords (file types like unify.yml/.dig) that would sharpen distinctiveness live in the body rather than the description.

Suggestions

Add concrete file-type triggers to the description (e.g., 'Use when documenting ID unification from .dig workflows or unify.yml configs').

Tighten the 'when' clause with concrete trigger phrases a user would say, mirroring the body's example requests.

State the concrete output artifact (Confluence parent + child pages) to raise specificity.

DimensionReasoningScore

Specificity

The description names the ID-unification domain plus several concrete deliverables ('Documents identity resolution algorithms, merge strategies, match rules, entity graphs, and multi-workflow orchestration'), but the actions are framed around documentation rather than showing what concrete artifacts it produces. It names the domain and a couple of concrete actions but is not comprehensive, matching the score-3 anchor; it is not a 4 because the actions are high-level and lack the depth of several specific concrete actions.

3 / 5

Completeness

It states what the skill does ('Expert documentation generation for ID unification layers. Documents...') and when to use it ('Use when documenting ID unification processes'), answering both what and when. The 'when' clause is present but generic rather than tied to concrete trigger phrases, so it lands at 4 rather than 5.

4 / 5

Trigger Term Quality

Natural trigger phrasing ('Use when documenting ID unification processes') plus domain keywords ('identity resolution', 'merge strategies', 'match rules', 'entity graphs') gives good keyword coverage that a user would plausibly say. It is not a 5 because common synonyms and concrete file/extension triggers (e.g., 'unify.yml', '.dig', 'Confluence') are absent from the description itself.

4 / 5

Distinctiveness Conflict Risk

The specialized ID-unification niche ('identity resolution algorithms, merge strategies, match rules, entity graphs, multi-workflow orchestration') is mostly distinct from generic documentation skills, with only minor overlap risk against a broader technical-writing skill. It is not a 5 because the trigger 'documenting ID unification' could overlap with a generic doc-generation skill rather than a tightly bounded niche.

4 / 5

Total

15

/

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
treasure-data/td-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.