Content
77%Weight 40%Scale 1-5Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
Highly actionable content with excellent workflow sequencing, validation checkpoints, and feedback loops, plus concrete commands for every documented script. The main costs are token weight — sizeable sections re-teach textbook organic chemistry Claude already knows — and one orphaned bundle script that is never surfaced for discovery.
Suggestions
Trim sections that restate textbook basics Claude already knows (R/S assignment steps, enantiomer/diastereomer/meso definitions, the n+1 rule, IR peak position basics) down to one-line reminders, keeping only the curated heuristics and strategy framing.
Document the orphaned scripts/molecular_complexity.py in the 'Bundled Scripts' section (or remove it from the bundle) so every script is discoverable from SKILL.md.
Move the named-reaction decision tree and spectroscopy reference values into a one-level-deep reference file (e.g. references/reaction-tables.md) to keep SKILL.md a lean overview, per the progressive-disclosure pattern.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and directive rather than padded, and curated heuristics (base size → Hofmann/Zaitsev, Wittig ylide E/Z, the decision tree) earn their tokens. However, substantial portions restate textbook curriculum Claude already knows — the n+1 splitting rule, IR carbonyl peak positions, CIP priority steps, and enantiomer/diastereomer/meso definitions — which could be cut to one-line reminders. Mostly efficient with unnecessary explanation that could be tightened fits anchor 3; not 2 because the writing is compact lists, not verbose padded prose. | 3 / 5 |
Actionability | Every bundled script has copy-paste-ready invocations with real flags and example values ('python smiles_verifier.py --smiles "..." --mw 198.15 --heavy_atoms 14'), the named-reaction guidance is a concrete lookup table, and all formulas (DoU, combustion, limiting reagent) are spelled out. Fully executable commands covering common cases match anchor 5. | 5 / 5 |
Workflow Clarity | Multi-step processes are clearly sequenced with explicit validation checkpoints: the 5-step product prediction ends in 'Sanity-check your product' with concrete checks, the spectroscopy section ends with 'Verify: does your proposed structure predict every observed signal?', and the SMILES design workflow has a true feedback loop ('If any constraint FAILs, revise and re-run until all pass'). Anchor 5's sequence-with-validation-and-feedback-loops pattern is met. | 5 / 5 |
Progressive Disclosure | This is a monolithic ~350-line SKILL.md with all reference detail inline and no reference files, though heavy data (reagent facts, crystal systems) is appropriately pushed into scripts. One bundle script, molecular_complexity.py, exists in scripts/ but is never mentioned in SKILL.md, making it undiscoverable. Some structure with clear sections, but content that could be separate is inline and a bundle member is orphaned — anchor 3; not 4 because of the undocumented script and lack of any file-level split. | 3 / 5 |
Total | 16 / 20 Passed |