Design gene circuits for synthetic biology applications
49
22%
Does it follow best practices?
Impact
100%
2.70xAverage score across 3 eval scenarios
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./scientific-skills/Data analysis/synthetic-bio-circuit-designer/SKILL.mdQuality
Discovery
22%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 description is too brief and vague to effectively guide skill selection. While it identifies a specialized domain (synthetic biology), it fails to specify concrete actions, lacks trigger guidance, and doesn't explain when the skill should be activated. The description would benefit significantly from expansion.
Suggestions
Add a 'Use when...' clause with trigger terms like 'gene circuit', 'synthetic biology', 'genetic toggle switch', 'promoter design', 'plasmid construction'
List specific concrete actions such as 'model regulatory networks, simulate circuit behavior, optimize genetic parts, generate DNA sequences'
Include common file types or tools users might mention like 'SBOL files', 'GenBank format', or 'parts registry'
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | The description uses vague language ('Design gene circuits') without listing concrete actions. It doesn't specify what designing entails - no mention of specific operations like modeling, simulating, optimizing, or generating sequences. | 1 / 3 |
Completeness | Only partially addresses 'what' (design gene circuits) and completely lacks a 'when' clause. There's no explicit guidance on when Claude should select this skill, missing the required 'Use when...' trigger guidance. | 1 / 3 |
Trigger Term Quality | Contains some relevant domain keywords ('gene circuits', 'synthetic biology') that users in this field would use, but misses common variations and related terms like 'genetic engineering', 'plasmid design', 'promoters', 'CRISPR', or 'biocircuits'. | 2 / 3 |
Distinctiveness Conflict Risk | The synthetic biology domain is fairly specialized which helps distinctiveness, but 'design' is generic and could overlap with other design-related skills. The lack of specific triggers increases potential for mismatches. | 2 / 3 |
Total | 6 / 12 Passed |
Implementation
22%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This skill is mostly administrative boilerplate with minimal actionable content for designing gene circuits. It tells Claude to run scripts but provides no guidance on what the scripts do, how to parameterize them, or how to interpret/validate results. The core synthetic biology domain knowledge is entirely absent.
Suggestions
Add concrete examples showing input parameters and expected output for each circuit type (toggle switch, oscillator)
Explain what --p1 and --p2 parameters represent and provide valid value ranges or examples
Include a sample output showing what 'circuit design', 'component list', and 'expected behavior' actually look like
Move risk assessment, security checklist, and lifecycle status to a separate metadata file or remove entirely - these don't help Claude execute the task
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill includes substantial boilerplate (risk assessment tables, security checklists, evaluation criteria, lifecycle status) that adds little value for Claude executing the task. The core content is lean but buried under administrative sections. | 2 / 3 |
Actionability | Provides only CLI usage examples without any actual implementation guidance. No code showing how circuits are designed, no parameter explanations, no examples of input/output formats. 'Circuit design' and 'Expected behavior' as outputs are completely vague. | 1 / 3 |
Workflow Clarity | No workflow is defined beyond running a script. Missing: how to interpret results, what parameters mean (--p1, --p2), how to iterate on designs, what validation looks like for gene circuits. The test cases section is generic placeholder text. | 1 / 3 |
Progressive Disclosure | Content is organized into sections, but the structure prioritizes administrative metadata over actionable content. No references to detailed documentation for circuit types, parameters, or advanced usage. The skill would benefit from separating risk/security into a separate file. | 2 / 3 |
Total | 6 / 12 Passed |
Validation
90%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 10 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
frontmatter_unknown_keys | Unknown frontmatter key(s) found; consider removing or moving to metadata | Warning |
Total | 10 / 11 Passed | |
ca9aaa4
Table of Contents
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.