Draft Diversity, Equity, and Inclusion statements for academic applications.
49
Quality
37%
Does it follow best practices?
Impact
Pending
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, specific niche (DEI statements for academic applications) which provides good distinctiveness. However, it lacks explicit trigger guidance ('Use when...'), lists only one action (draft), and misses common keyword variations like 'DEI statement' that users would naturally say. The description needs expansion to help Claude know when to select this skill.
Suggestions
Add a 'Use when...' clause with trigger terms like 'DEI statement', 'diversity statement', 'faculty application', 'academic job application', 'tenure-track position'
Expand the action list to include related capabilities such as 'review existing statements', 'tailor to specific institutions', or 'provide feedback on drafts'
Include the common abbreviation 'DEI' as a standalone trigger term since users frequently use this shorthand
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Names the domain (DEI statements) and one action (draft), but doesn't list multiple concrete actions like reviewing, editing, tailoring to specific institutions, or providing feedback on existing statements. | 2 / 3 |
Completeness | Describes what it does (draft DEI statements) but completely lacks a 'Use when...' clause or any explicit trigger guidance for when Claude should select this skill. Per rubric guidelines, missing explicit trigger guidance caps completeness at 2, and this is weaker than that. | 1 / 3 |
Trigger Term Quality | Includes relevant keywords like 'Diversity, Equity, and Inclusion statements' and 'academic applications', but misses common variations users might say such as 'DEI statement', 'diversity statement', 'inclusion statement', 'faculty application', or 'job application'. | 2 / 3 |
Distinctiveness Conflict Risk | Clear niche focusing specifically on DEI statements for academic applications - this is distinct enough that it's unlikely to conflict with general writing skills or other academic document skills. | 3 / 3 |
Total | 8 / 12 Passed |
Implementation
35%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This skill is heavily padded with generic boilerplate (security checklists, risk assessments, lifecycle status) that provides no value for drafting DEI statements. The actual domain-specific content—what makes a good DEI statement, examples, writing guidance—is minimal. The skill prioritizes process documentation over actionable DEI writing instruction.
Suggestions
Remove boilerplate sections (Risk Assessment, Security Checklist, Lifecycle Status, Evaluation Criteria) that don't help Claude draft better DEI statements
Add concrete examples of effective DEI statement paragraphs with annotations explaining what makes them strong
Replace the vague 'Statement Components' list with specific guidance: what to include in personal background, how to describe experiences concretely, what 'future plans' should look like
Consolidate redundant workflow/usage sections into a single clear process with DEI-specific quality checkpoints
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Extremely verbose with excessive boilerplate sections (Risk Assessment, Security Checklist, Lifecycle Status, Evaluation Criteria) that add no value for a DEI statement drafting skill. Contains redundant cross-references ('See ## Prerequisites above') and generic template content that wastes tokens. | 1 / 3 |
Actionability | Provides CLI commands and parameter documentation, but the actual DEI statement drafting guidance is minimal. The 'Statement Components' section lists vague categories without concrete examples of good DEI statements or specific writing guidance. | 2 / 3 |
Workflow Clarity | Has a numbered workflow section but it's generic process boilerplate rather than DEI-specific guidance. Missing concrete validation steps for statement quality or content review checkpoints specific to academic DEI statements. | 2 / 3 |
Progressive Disclosure | References external files (references/audit-reference.md, scripts/main.py) but the main document is bloated with sections that should be elsewhere or removed entirely. The structure exists but content organization is poor with redundant sections. | 2 / 3 |
Total | 7 / 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 | |
4a48721
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.