CtrlK
BlogDocsLog inGet started
Tessl Logo

aps-doc-master-segment

Generate Confluence-ready technical documentation for CDP Parent Segments. Produces structured docs covering attribute schemas, behavior definitions, star schema relationships, and data lineage. Use when you need to write docs, create specs, or explain parent segment architecture.

68

Quality

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

SKILL.md
Quality
Evals
Security

Quality

Content

65%

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

The skill is actionable with concrete tdx/MCP commands and a complete template, and its phases are well sequenced. It is weakened by verbosity from repeated conditional blocks, a missing output-validation feedback loop, and a monolithic structure that should offload the large template to a reference file.

Suggestions

Collapse the repeated 'If X columns exist →' blocks in Business Value, Personalization, Performance Analytics, Lifecycle, and Recommendations into a single concise rule and remove redundant CAPS/CRITICAL emphasis to tighten the body.

Add an output validation step (e.g., verify every table/column referenced in the generated doc exists in the queried schema, and re-query on mismatch) before marking the document 'Production Ready'.

Move the large documentation template into a references file (e.g., references/template.md) and reference it from SKILL.md so the overview stays lean.

DimensionReasoningScore

Conciseness

The ~390-line body is padded with heavily repeated 'If X columns exist →' conditional blocks across marketing, personalization, analytics, lifecycle, and recommendations sections, plus excessive CAPS/'CRITICAL' emphasis that could be tightened without losing clarity.

2 / 3

Actionability

Provides concrete, executable commands ('tdx use database ...', 'tdx tables', 'tdx describe <table>'), specific MCP tool guidance, and a complete output template — copy-paste ready guidance rather than abstract direction.

3 / 3

Workflow Clarity

Sequencing is clear (Phase 1 Discovery, Phase 2 Extraction, Phase 3 Generation) with a pre-flight checklist and 'STOP if cannot access database', but there is no output validation/feedback loop to verify the generated documentation before finalizing.

2 / 3

Progressive Disclosure

The entire documentation template (roughly lines 77–316) and all guidance live inline in one monolithic ~390-line file with no bundle files or references, so content that should be split into a separate template reference is not separated.

2 / 3

Total

9

/

12

Passed

Description

100%

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 is third-person, concise, and clearly states both what the skill does and when to use it with concrete actions and natural trigger terms. It is a strong, low-conflict description.

DimensionReasoningScore

Specificity

Lists multiple concrete actions — 'Generate Confluence-ready technical documentation', 'Produces structured docs covering attribute schemas, behavior definitions, star schema relationships, and data lineage' — matching the multi-action anchor.

3 / 3

Completeness

Explicitly answers both what (generate Confluence-ready docs covering named components) and when via an explicit 'Use when you need to write docs, create specs, or explain parent segment architecture' clause.

3 / 3

Trigger Term Quality

Includes natural user phrasing such as 'write docs, create specs, or explain parent segment architecture', giving good coverage of terms a user would say.

3 / 3

Distinctiveness Conflict Risk

Targets a clear niche — CDP Parent Segment documentation — with distinct, specialized triggers unlikely to fire for unrelated skills.

3 / 3

Total

12

/

12

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.

Validation16 / 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.