Draft Diversity, Equity, and Inclusion statements for academic applications.
32
27%
Does it follow best practices?
Impact
—
No eval scenarios have been run
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./scientific-skills/Academic Writing/dei-statement-drafter/SKILL.mdQuality
Discovery
40%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
The description identifies a clear and distinctive niche—DEI statements for academic applications—but is too terse. It lacks a 'Use when...' clause with explicit trigger terms, and it only names a single action ('draft') without elaborating on the range of capabilities or common user phrasings that would help Claude select this skill appropriately.
Suggestions
Add a 'Use when...' clause with trigger terms like 'diversity statement', 'DEI essay', 'faculty application', 'graduate school application', 'academic job'.
Expand the action list beyond 'draft' to include related capabilities such as 'review, revise, tailor to specific institutions, and structure DEI narratives'.
Include common keyword variations users might use, such as 'diversity statement', 'inclusion statement', 'DEI essay', and 'academic position application'.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Names the domain (DEI statements for academic applications) and one action (draft), but does not list multiple specific concrete actions such as reviewing, editing, tailoring to specific institutions, or structuring sections. | 2 / 3 |
Completeness | Describes what the skill does (drafts DEI statements) but has no explicit 'Use when...' clause or equivalent trigger guidance, which per the rubric caps completeness at 2, and the 'what' itself is also thin, bringing it to 1. | 1 / 3 |
Trigger Term Quality | Includes relevant keywords like 'Diversity, Equity, and Inclusion,' 'DEI,' and 'academic applications,' but misses common variations users might say such as 'DEI statement,' 'diversity statement,' 'faculty application,' 'grad school,' or 'job application.' | 2 / 3 |
Distinctiveness Conflict Risk | The combination of DEI statements specifically for academic applications is a clear niche that is unlikely to conflict with other skills, as it targets a very specific document type and context. | 3 / 3 |
Total | 8 / 12 Passed |
Implementation
14%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This skill is overwhelmingly boilerplate with very little DEI-statement-specific content. The actual domain knowledge — how to write a compelling DEI statement, what makes one effective, examples of good vs. bad statements — is almost entirely absent, replaced by generic project scaffolding (risk assessments, security checklists, lifecycle status). The circular internal cross-references and repetitive sections make it harder to follow rather than easier.
Suggestions
Replace the generic boilerplate (Risk Assessment, Security Checklist, Lifecycle Status, Evaluation Criteria, Response Template) with actual DEI statement writing guidance: examples of strong statements, common pitfalls, discipline-specific considerations, and sample input/output pairs.
Add at least one concrete example showing input experiences and the resulting DEI statement draft, so Claude knows what quality output looks like.
Remove circular self-references ('See ## X above') and consolidate the duplicated workflow/implementation/example sections into a single clear workflow with DEI-specific validation steps (e.g., 'Verify statement addresses past actions, not just aspirations').
Either provide the referenced bundle files (scripts/main.py, references/audit-reference.md) or remove references to them and instead embed the essential guidance directly in the skill.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Extremely verbose and repetitive. Contains numerous sections that restate the same information (e.g., 'See ## Prerequisites above', 'See ## Usage above', 'See ## Workflow above' cross-references to sections within the same document). Includes boilerplate sections like Risk Assessment, Security Checklist, Lifecycle Status, Evaluation Criteria, and Response Template that add no DEI-statement-specific value. Much of the content is generic scaffolding that Claude already knows how to do (error handling patterns, input validation concepts, output structuring). | 1 / 3 |
Actionability | Provides some concrete commands (python scripts/main.py --template faculty --experiences experiences.txt) and a parameter table, but the actual DEI statement drafting guidance is extremely thin — 'Statement Components' is just four bullet points with no examples of good DEI statements, no templates, no sample input/output. The skill relies entirely on an opaque scripts/main.py without showing what it actually produces or how to draft a DEI statement without it. | 2 / 3 |
Workflow Clarity | The workflow section is entirely generic ('Confirm the user objective', 'Validate that the request matches the documented scope') with no DEI-statement-specific steps. There are no validation checkpoints for the actual content quality of a DEI statement. The 'Example run plan' duplicates the workflow with equally vague steps. No feedback loop for reviewing or improving the generated statement. | 1 / 3 |
Progressive Disclosure | The document contains circular self-references ('See ## Prerequisites above', 'See ## Usage above', 'See ## Workflow above') that point to sections within the same file, creating confusion rather than progressive disclosure. References a 'references/audit-reference.md' file but no bundle files are provided. The document is a monolithic wall of boilerplate with poor organization — related content is scattered across multiple sections (Implementation Details, Workflow, Example Usage all overlap). | 1 / 3 |
Total | 5 / 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 | |
73f6514
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.