CtrlK
BlogDocsLog inGet started
Tessl Logo

grant-budget-justification

Use grant budget justification for academic writing workflows that need structured execution, explicit assumptions, and clear output boundaries.

36

Quality

33%

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./scientific-skills/Academic Writing/grant-budget-justification/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

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 names a specific domain (grant budget justification) but fails to articulate what concrete actions the skill performs. The 'when' guidance is present but generic, and the lack of specific capabilities makes it hard for Claude to confidently select this skill over others. The description reads more like a category label than a functional guide.

Suggestions

Add concrete actions the skill performs, e.g., 'Generates line-item budget tables, writes personnel and equipment cost justifications, and calculates indirect cost rates for grant proposals.'

Expand trigger terms to include common variations users would say, such as 'NSF budget narrative,' 'NIH budget justification,' 'research funding proposal,' 'cost breakdown,' or 'grant proposal budget.'

Strengthen the 'when' clause with explicit triggers, e.g., 'Use when the user asks to draft or review a budget justification for a grant proposal, or mentions terms like budget narrative, cost justification, or funding request.'

DimensionReasoningScore

Specificity

The description does not list any concrete actions. 'Structured execution, explicit assumptions, and clear output boundaries' are abstract process descriptors, not specific capabilities like 'create budget tables' or 'calculate personnel costs'.

1 / 3

Completeness

The 'when' is partially addressed with 'Use [for] academic writing workflows that need structured execution,' but the 'what' is essentially missing—there is no explanation of what the skill actually does beyond the domain label 'grant budget justification.'

2 / 3

Trigger Term Quality

It includes some relevant keywords like 'grant budget justification' and 'academic writing,' which a user might naturally mention. However, it misses common variations such as 'NSF budget,' 'NIH justification,' 'research proposal budget,' 'cost justification,' or 'funding proposal.'

2 / 3

Distinctiveness Conflict Risk

'Grant budget justification' is a fairly specific niche, which helps distinctiveness. However, the vague phrasing around 'academic writing workflows' and 'structured execution' could overlap with other academic writing or general document-structuring skills.

2 / 3

Total

7

/

12

Passed

Implementation

27%

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 (risk assessment, security checklist, lifecycle status, evaluation criteria) that provides no domain-specific value for grant budget justification. The core task—generating narrative budget justifications—is poorly served: there are no concrete examples of input budget data or expected justification prose, and the workflow is generic rather than tailored to academic grant writing. The document would benefit enormously from cutting 60-70% of its content and replacing it with 2-3 concrete input/output examples specific to NIH/NSF budget justifications.

Suggestions

Remove boilerplate sections (Risk Assessment, Security Checklist, Lifecycle Status, Evaluation Criteria) that don't provide task-specific guidance, and eliminate repeated content like the triplicated py_compile command.

Add 2-3 concrete, complete examples showing actual budget input data (e.g., a JSON snippet with personnel costs) and the expected narrative justification output text for specific agencies like NIH and NSF.

Replace the generic workflow steps with domain-specific guidance: how to structure justifications by category (equipment vs. personnel vs. travel), what agency-specific compliance language to include, and what makes a strong cost-benefit rationale.

Fix broken internal cross-references ('See ## Prerequisites above' and 'See ## Workflow above') and ensure referenced files like 'references/audit-reference.md' actually exist in the bundle.

DimensionReasoningScore

Conciseness

Extremely verbose and repetitive. Multiple sections restate the same information (e.g., 'python -m py_compile scripts/main.py' appears three times, the skill description is repeated verbatim in 'When to Use' and 'Key Features'). Sections like 'Risk Assessment', 'Security Checklist', 'Lifecycle Status', and 'Evaluation Criteria' are boilerplate that add no task-specific value. Cross-references to non-existent sections ('See ## Prerequisites above') add confusion. Much of the content explains generic workflow discipline that Claude already knows.

1 / 3

Actionability

The Parameters table with CLI flags is concrete and useful, and the example commands are executable. However, the core task—writing budget justification narratives—lacks concrete examples of actual input data and expected output text. The single example ('$50,000 for mass spectrometer → Justification emphasizing essentiality and cost-sharing') is too vague to be actionable. The workflow steps are generic process descriptions rather than specific instructions for generating budget justifications.

2 / 3

Workflow Clarity

There is a numbered workflow with steps for validation and fallback handling, and the error handling section provides reasonable guidance. However, the workflow is generic and not specific to budget justification writing. There are no validation checkpoints for the actual output quality (e.g., checking compliance with agency requirements, verifying cost calculations). The 'Example run plan' and 'Workflow' sections are redundant and neither provides domain-specific validation steps.

2 / 3

Progressive Disclosure

The document is a monolithic wall of text with 15+ sections, many of which are boilerplate or redundant. It references 'references/audit-reference.md' and 'references/' directory but no bundle files are provided to verify these exist. Internal cross-references point to non-existent anchors ('See ## Prerequisites above' appears before Prerequisites). Content that could be in separate files (security checklist, risk assessment, evaluation criteria) is inlined, while the actual domain-specific guidance that should be front-and-center is buried or absent.

1 / 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.

Validation10 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

10

/

11

Passed

Repository
aipoch/medical-research-skills
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.