CtrlK
BlogDocsLog inGet started
Tessl Logo

aps-doc-ingestion

Expert documentation generation for ingestion layers. Automatically detects connector types (REST API, Database, File, Streaming), documents authentication patterns, rate limiting strategies, and incremental load patterns. Use when documenting data source ingestion workflows.

47

Quality

48%

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Risky

Do not use without reviewing

Optimize this skill with Tessl

npx tessl skill review --optimize ./aps-doc-skills/ingestion/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Discovery

85%

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 is a strong description that clearly articulates specific capabilities and includes an explicit 'Use when' trigger clause. Its main weakness is that the trigger terms lean toward technical jargon rather than natural language a user might employ, potentially missing common synonyms like 'ETL', 'data pipeline', or 'integration layer'.

Suggestions

Add common user-facing synonyms to the 'Use when' clause, such as 'ETL documentation', 'data pipeline docs', 'data integration', or 'source connector documentation' to improve trigger term coverage.

DimensionReasoningScore

Specificity

Lists multiple specific concrete actions: detects connector types (with examples), documents authentication patterns, rate limiting strategies, and incremental load patterns. The parenthetical examples add further specificity.

3 / 3

Completeness

Clearly answers both 'what' (documentation generation for ingestion layers, detecting connector types, documenting auth patterns, rate limiting, incremental loads) and 'when' ('Use when documenting data source ingestion workflows'). The explicit 'Use when...' clause is present.

3 / 3

Trigger Term Quality

Includes relevant domain terms like 'ingestion', 'connector types', 'REST API', 'Database', 'Streaming', and 'data source', but misses common user variations like 'ETL', 'data pipeline', 'data integration', 'source connectors', or 'ingestion pipeline docs'. The terms lean more technical than what a typical user might naturally say.

2 / 3

Distinctiveness Conflict Risk

Highly specific niche targeting ingestion layer documentation with distinct triggers like connector types, rate limiting strategies, and incremental load patterns. Unlikely to conflict with general documentation or other data engineering skills.

3 / 3

Total

11

/

12

Passed

Implementation

12%

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

This skill is extremely verbose and descriptive rather than actionable. It catalogs many connector types, authentication patterns, and detection capabilities at great length, but never provides concrete code or commands for actually performing the detection or documentation generation. The template section is a useful skeleton but would be better served as a separate referenced file, and the entire document would benefit from being condensed to ~25% of its current size with actual executable extraction logic added.

Suggestions

Replace the descriptive 'Detects/Documents' YAML blocks with actual executable code showing how to parse .dig and .yml files (e.g., Python/shell commands to extract connector types, table names, incremental fields).

Move the documentation templates (parent page and child page) into separate referenced files (e.g., PARENT_TEMPLATE.md, CHILD_TEMPLATE.md) to reduce the main skill's size and improve progressive disclosure.

Cut the Auto-Detection Capabilities section to a concise table mapping config patterns to connector types, rather than repeating the same Detects/Documents structure for every variant.

Add explicit validation checkpoints in the workflow: e.g., verify extracted table count matches datasources.yml, confirm all referenced .dig files were found, validate generated documentation against template completeness checklist.

DimensionReasoningScore

Conciseness

Extremely verbose at ~300+ lines. Massive amounts of content that describe what the skill 'detects' and 'documents' in repetitive YAML blocks rather than providing actionable instructions. Much of this is descriptive catalog content that Claude could infer (e.g., explaining what OAuth 2.0 is, what API keys are, what Kafka topics are). The 'Auto-Detection Capabilities' section alone is enormous and mostly tells Claude things it already knows.

1 / 3

Actionability

Despite its length, the skill contains no executable code, no concrete commands for reading .dig or .yml files, and no real examples of how to parse configurations. The template section is a markdown skeleton with placeholders like '{Brief description}' rather than concrete extraction logic. The 'detects from configuration' blocks describe what to look for but never show how to actually extract or process the data.

1 / 3

Workflow Clarity

There is a rough sequence implied: get codebase access → verify files exist → detect patterns → generate documentation using template. The mandatory codebase access section provides a clear gate. However, the actual workflow for generating documentation lacks explicit validation steps, feedback loops, or checkpoints. No verification that generated documentation is accurate or complete.

2 / 3

Progressive Disclosure

This is a monolithic wall of text with no references to external files despite being an ideal candidate for splitting (e.g., templates could be in separate files, connector-specific detection patterns could be in reference docs). Everything is inlined in one massive document with no bundle files to support it.

1 / 3

Total

5

/

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.

Validation11 / 11 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.