CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

astropy

Comprehensive Python library for astronomy and astrophysics. This skill should be used when working with astronomical data including celestial coordinates, physical units, FITS files, cosmological calculations, time systems, tables, world coordinate systems (WCS), and astronomical data analysis. Use when tasks involve coordinate transformations, unit conversions, FITS file manipulation, cosmological distance calculations, time scale conversions, or astronomical data processing.

63

Quality

79%

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 ./skills_all/astropy/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

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

A well-organized library-overview skill whose main strengths are fully executable quick-start and workflow code and clear per-module navigation. It is held back by localized verbosity (duplicated when-to-use and reference listings) and, most importantly, by referencing seven reference files that are absent from the bundle, breaking its progressive-disclosure structure.

Suggestions

Ship the seven referenced files (references/units.md, coordinates.md, cosmology.md, fits.md, tables.md, time.md, wcs_and_other_modules.md) or remove the dangling pointers — the skill's detail layer currently does not exist.

Cut the duplicated content: drop the 'When to Use This Skill' section (it repeats the frontmatter description) and the trailing 'Reference Files' list (it repeats the inline 'See:' pointers).

Remove or compress the generic Overview sentence ('Astropy is the core Python package for astronomy...') — it explains knowledge Claude already has and adds no actionable guidance.

DimensionReasoningScore

Conciseness

Mostly efficient module overviews with useful code, but several padded spots: the Overview sentence explains what Astropy is (knowledge Claude already has), the 'When to Use This Skill' section duplicates the frontmatter description, and the trailing 'Reference Files' section repeats the per-module 'See:' pointers already given inline. This fits anchor 3 ('mostly efficient but includes some unnecessary explanation or could be tightened') better than 2, since the padding is localized rather than pervasive.

3 / 5

Actionability

The Quick Start and all four Common Workflows (coordinate transformation, FITS reading, cosmological distances, catalog cross-matching) are complete, executable, copy-paste-ready Python covering the common cases, plus concrete install commands. This matches the anchor-5 example's fully executable, common-case coverage.

5 / 5

Workflow Clarity

Each workflow is a clear, unambiguous sequence with correct dependency ordering (e.g., constructing AltAz frames with obstime and location before transforming). Not 5 because no verification steps appear (e.g., checking FITS file structure before indexing HDUs), though the operations are read-only so the destructive/batch cap at 3 does not apply.

4 / 5

Progressive Disclosure

The in-body structure is well-signaled — each module section points one level deep to 'references/<module>.md' with a description of what it contains — but the bundle contains no references/ directory at all, so all seven referenced files are dangling and the progressive-disclosure chain is broken. Not 4/5 because navigation to the detailed material fails in practice; not 2 because the SKILL.md itself is well organized with clear, prominent reference signaling.

3 / 5

Total

15

/

20

Passed

Description

78%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 with an explicit 'Use when' trigger clause and a rich set of natural domain keywords. Its main weakness is that the 'what' portion is a generic 'comprehensive library' statement rather than a concrete enumeration of capabilities, which keeps specificity and completeness at 4 instead of 5.

Suggestions

Rewrite the opening 'what' clause to enumerate concrete capabilities in third-person imperative form (e.g., 'Transforms celestial coordinates, converts physical units, reads and writes FITS files, computes cosmological distances, and handles astronomical time systems and tables').

Add common user phrasings and file extensions to the trigger list, such as '.fits'/'FITS images', 'redshift', 'astrometry', and 'astronomical catalogs'.

Trim the near-duplicate trigger enumeration ('astronomical data analysis' / 'astronomical data processing' appear in both sentences) to reduce padding without losing coverage.

DimensionReasoningScore

Specificity

The opening 'Comprehensive Python library for astronomy and astrophysics' names the domain generically, but the trigger clause enumerates concrete operations ('coordinate transformations, unit conversions, FITS file manipulation, cosmological distance calculations, time scale conversions'), matching anchor 4's 'several specific actions; minor gaps'. Not 5 because the headline 'what' lacks the imperative action verbs of the anchor-5 example, and not 3 because coverage goes well beyond 1-2 actions.

4 / 5

Completeness

Explicitly answers both: 'what' ('Comprehensive Python library for astronomy and astrophysics... astronomical data analysis') and 'when' ('This skill should be used when working with... Use when tasks involve...') with concrete trigger phrases. Not 5 because the 'what' is a domain-level statement rather than a concrete list of what the skill does; the 'when' is strong enough to rule out 3.

4 / 5

Trigger Term Quality

Good natural-term coverage: 'astronomical data', 'celestial coordinates', 'physical units', 'FITS files', 'cosmological calculations', 'time systems', 'world coordinate systems (WCS)', 'unit conversions'. Not 5 because common variations users would say are missing (e.g., '.fits' extension, 'redshift', 'astrometry', 'photometry'); not 3 because the phrase set is broad and domain-natural rather than merely 'some relevant keywords'.

4 / 5

Distinctiveness Conflict Risk

Clear astronomy niche with distinct triggers (FITS, WCS, celestial coordinates, cosmological distances) that no generic data-processing or units skill would claim; minimal conflict risk with closely related skills.

5 / 5

Total

17

/

20

Passed

Validation

93%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

referenced_paths_exist

Referenced path issues: 15 missing

Warning

Total

15

/

16

Passed

Repository

Microck/ordinary-claude-skills

Path

skills_all/astropy/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.