CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

fastqc-report-interpreter

Use when analyzing FASTQC quality reports from sequencing data, identifying quality issues in NGS datasets, or troubleshooting sequencing problems. Interprets quality metrics and provides actionable recommendations for RNA-seq, DNA-seq, and ChIP-seq data.

Quality

69%

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 ./scientific-skills/Data Analysis/fastqc-report-interpreter/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 FASTQC-specific core (quality thresholds, common-issue diagnosis, application-specific guidance) is genuinely valuable, but it is buried in generic template padding and undermined by a systematic mismatch with the actual bundle: every shown API/CLI entry point except `scripts/main.py` verification commands references files, classes, methods, or flags that do not exist. The skill needs a verification pass against `scripts/main.py` and removal of the duplicated boilerplate.

Suggestions

Regenerate all code and CLI examples from the actual bundle: import `FastQCInterpreter` from `scripts/main.py`, document the real methods (`interpret_report`, `interpret_module`, `get_recommendations`, `print_report`) and real CLI flags (`--report/-r`, `--demo`) instead of the nonexistent `fastqc_interpreter.py` / `analyze` / `--input` / `--batch` / `--application` surface.

Remove the generic template sections (Output Requirements, Response Template, Input Validation, Error Handling) and the duplicated py_compile blocks, and stop pasting the frontmatter description into the body — keep the SKILL.md focused on the FASTQC workflow.

Fix or create `references/troubleshooting.md`, or drop the reference; move the threshold tables and issue catalog into a single reference file so SKILL.md stays a navigable overview.

DimensionReasoningScore

Conciseness

Noticeably verbose with several padded sections: the frontmatter description is pasted verbatim twice into the body ("Use this skill when the task needs Use when analyzing FASTQC quality reports..." and "Scope-focused workflow aligned to: Use when analyzing FASTQC quality reports..."), the same `python -m py_compile scripts/main.py` check appears in three separate sections (Example Usage, Quick Check, Audit-Ready Commands), and roughly half the body is generic template boilerplate ("Output Requirements", "Response Template", "Input Validation", "Error Handling") unrelated to FASTQC. The genuinely useful FASTQC-specific content (threshold table, common issues) cannot lift it to 3 because the padding is pervasive rather than incidental.

2 / 5

Actionability

Concrete code and commands are present (the metrics table, issue/solution pairs, `python -m py_compile scripts/main.py`, `python scripts/main.py --help` — both of which work), but the primary API surface shown does not match the actual bundle: `from scripts.fastqc_interpreter import FASTQCInterpreter` targets a nonexistent file with a misspelled class (actual: `FastQCInterpreter` in `scripts/main.py`), the shown methods `analyze`, `parse_metrics`, `diagnose_issues`, `analyze_batch` do not exist (actual: `interpret_report`, `interpret_module`, `get_recommendations`, `print_report`), and the CLI section's `--input`, `--batch`, `--application` flags do not exist (actual: `--report`/`-r`, `--demo`). Like the 3 anchor, guidance is concrete but incomplete/unreliable; not lower because the verification commands and threshold tables are directly usable.

3 / 5

Workflow Clarity

Steps are listed (the 5-step "Workflow" and 4-step "Example run plan") with some checkpoints ("stop early if the task would require unsupported assumptions", the Quick Check verification command, and an explicit fallback path), but there are three competing workflow framings (Example run plan, Workflow, Response Template) and the actual report-analysis sequence is unusable because the documented CLI/API is wrong — a user following it hits immediate failures. Batch analysis (`--batch`, `analyze_batch`) is documented without any batch-specific validation, which caps workflow clarity at 3 per the batch-operations rule.

3 / 5

Progressive Disclosure

The actual bundle contains only `scripts/main.py`, yet the body directs readers to `scripts/fastqc_interpreter.py` (two places) and "See `references/troubleshooting.md`" — none of which exist, so navigation dead-ends. Additionally, reference-grade material (the full metrics threshold table, application-specific thresholds, and the complete issue-diagnosis catalog) is inlined in an already over-long SKILL.md. This matches the 2 anchor: references are effectively broken/buried and content that belongs in separate files is inlined; not 1 because the document itself is sectioned and the one real script path is correctly identified in several places.

2 / 5

Total

10

/

20

Passed

Description

87%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.

A strong description: it pairs an explicit multi-trigger "Use when" clause with a concrete, domain-specific capability statement covering three sequencing applications. The only notable gap is the absence of file-extension/synonym variants a user might naturally mention.

DimensionReasoningScore

Specificity

Lists several concrete domain-specific actions — "analyzing FASTQC quality reports", "identifying quality issues", "troubleshooting sequencing problems", "Interprets quality metrics", "provides actionable recommendations" — plus three named applications (RNA-seq, DNA-seq, ChIP-seq). Falls short of the 5 anchor because the actions overlap in meaning (analyzing/identifying/troubleshooting are near-synonyms) and no output artifacts or file types are named.

4 / 5

Completeness

Explicitly answers both questions: the "when" leads with "Use when analyzing FASTQC quality reports from sequencing data, identifying quality issues in NGS datasets, or troubleshooting sequencing problems" and the "what" states "Interprets quality metrics and provides actionable recommendations for RNA-seq, DNA-seq, and ChIP-seq data" — matching the 5 anchor's pattern of concrete trigger phrases plus a clear capability statement.

5 / 5

Trigger Term Quality

Good natural keyword coverage: "FASTQC quality reports", "sequencing data", "NGS datasets", "sequencing problems", "RNA-seq", "DNA-seq", "ChIP-seq" — terms a user would plausibly say. Missing common variations like "FastQC report" casing, "QC report", "read quality", or file extensions (fastqc.html, fastqc_data.txt), so it does not reach the comprehensive-synonym coverage of the 5 anchor.

4 / 5

Distinctiveness Conflict Risk

"FASTQC" names a specific tool and the NGS/RNA-seq/ChIP-seq framing carves out a clear niche with minimal conflict risk against unrelated skills; only very closely adjacent bioinformatics-QC skills could overlap, which the 5 anchor permits.

5 / 5

Total

18

/

20

Passed

Validation

87%

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

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

referenced_paths_exist

Referenced path issues: 4 missing

Warning

Total

14

/

16

Passed

Repository

aipoch/medical-research-skills

Path

scientific-skills/Data Analysis/fastqc-report-interpreter/SKILL.md

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.