Use when determining author order on research manuscripts, assigning CRediT contributor roles for transparency, documenting individual contributions to collaborative projects, or resolving authorship disputes in multi-institutional research. Generates fair and transparent authorship assignments following ICMJE guidelines and CRediT taxonomy. Helps research teams document contributions, resolve disputes, and ensure equitable credit distribution in academic publications.
49
53%
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/authorship-credit-gen/SKILL.mdQuality
Discovery
100%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
This is a strong skill description that clearly defines its niche in academic authorship and contribution management. It effectively combines a 'Use when...' clause with specific trigger scenarios and follows up with concrete capabilities. The domain-specific terminology (ICMJE, CRediT taxonomy) provides excellent distinctiveness while remaining natural to the target user base of researchers.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple specific concrete actions: determining author order, assigning CRediT contributor roles, documenting individual contributions, resolving authorship disputes, and generating fair authorship assignments following ICMJE guidelines and CRediT taxonomy. | 3 / 3 |
Completeness | Clearly answers both 'what' (generates fair authorship assignments, documents contributions, resolves disputes) and 'when' with an explicit 'Use when...' clause listing four specific trigger scenarios (determining author order, assigning CRediT roles, documenting contributions, resolving disputes). | 3 / 3 |
Trigger Term Quality | Excellent coverage of natural terms users would say: 'author order', 'research manuscripts', 'CRediT', 'contributor roles', 'authorship disputes', 'multi-institutional research', 'ICMJE guidelines', 'academic publications', 'contributions'. These are terms researchers would naturally use when seeking this kind of help. | 3 / 3 |
Distinctiveness Conflict Risk | Highly distinctive niche focused specifically on research authorship, CRediT taxonomy, and ICMJE guidelines. This is unlikely to conflict with other skills given its very specific academic publishing domain and unique trigger terms like 'author order', 'CRediT', and 'authorship disputes'. | 3 / 3 |
Total | 12 / 12 Passed |
Implementation
7%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This skill is a heavily templated, boilerplate-driven document that repeats its description multiple times and provides fabricated code examples that almost certainly don't correspond to real implementations. The workflow guidance is entirely generic with no domain-specific authorship determination logic. The skill fails to provide genuine, actionable guidance for authorship credit generation despite its considerable length.
Suggestions
Remove all duplicate content: the description appears verbatim in at least 3 sections. Consolidate 'When to Use' and 'When to Use This Skill' into one brief section.
Replace fabricated API examples with actual executable code from scripts/main.py, or if the script is simple, show its real interface and usage patterns.
Add a concrete, domain-specific workflow for authorship determination: e.g., 1) Collect contribution data in specific format, 2) Apply ICMJE criteria checklist, 3) Calculate weighted scores, 4) Validate against CRediT taxonomy, 5) Generate output.
Remove generic boilerplate sections (Output Requirements, Response Template, Input Validation, Error Handling) that contain no authorship-specific content and waste token budget.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Extremely verbose and repetitive. The description is copy-pasted verbatim into 'When to Use', 'Key Features', and 'When to Use This Skill' sections. Multiple redundant sections (two 'References' sections, repeated py_compile commands in both 'Quick Check' and 'Audit-Ready Commands'). The generic workflow, error handling, input validation, output requirements, and response template sections are boilerplate that add no domain-specific value. Explains obvious concepts Claude already knows. | 1 / 3 |
Actionability | The code examples are entirely fabricated pseudocode referencing non-existent classes and methods (AuthorshipCreditGenerator, tool.calculate_contribution_scores, tool.assign_credit_roles, etc.) with no evidence these exist in the actual scripts/main.py. None of the Python examples are executable or copy-paste ready. The skill provides the illusion of actionability through elaborate API calls that likely don't correspond to real implementations, especially given no bundle files were provided to verify. | 1 / 3 |
Workflow Clarity | The 'Workflow' section is entirely generic (confirm objective, validate request, use packaged script, return structured result) with no authorship-specific steps. There are no validation checkpoints specific to authorship determination, no feedback loops for dispute resolution, and no concrete sequence for actually generating authorship orders. The 'Example run plan' is also generic boilerplate. | 1 / 3 |
Progressive Disclosure | References to external files (references/guide.md, references/examples/, references/api-docs/, references/audit-reference.md) are present and signaled, which shows some structural intent. However, no bundle files exist to verify these references are real. The main document itself is a monolithic wall of repetitive content that could benefit significantly from splitting, and the inline content is poorly organized with redundant sections. | 2 / 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 | |
d3c2c0f
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.