CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

academic-paper

12-agent academic paper writing pipeline. 11 modes (full/plan/outline/revision/revision-coach/abstract/lit-review/format-convert/citation-check/disclosure/rebuttal-audit). 6 paper types, 5 citation formats, bilingual abstracts, LaTeX/DOCX-via-Pandoc/PDF output. Style Calibration + Writing Quality Check + Anti-Patterns with IRON RULE markers. Triggers: write paper, academic paper, guide my paper, parse reviews, I got reviewer comments, revision roadmap, should we push back, conference rebuttal, grant panel response, audit my rebuttal, check my response draft, AI disclosure, check citations, citation check, check my references, verify references, look over the refs, 寫論文, 學術論文, 引導我寫論文, 審查意見, 我收到審查意見, 修訂路線圖, 評估回覆, 檢查引用, 引用檢查, 檢查參考文獻, 核對文獻, 논문 작성, 초록 작성, 논문 수정, 논문 계획을 도와줘, 심사 의견을 받았어, 심사 의견 반영, 답변서 점검, AI 사용 고지, 인용 확인, 인용 형식 검사, enmendar mi artículo, redactar artículo, guía mi artículo, analizar reseñas, auditar mi respuesta, verificar borrador de respuesta, verificar citas, divulgación de IA.

Quality

70%

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 ./academic-paper/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

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

The skill's skeleton is solid — clear phase workflow, explicit checkpoints, well-organized reference files — but the body is bloated with internal versioning spec and cites many bundle-inconsistent paths. It functions more as a design-log transcript than a lean operational guide.

Suggestions

Move the v3.6.6 Generator-Evaluator Contract Protocol, the routing-core block, and the inlined bilingual review-form note into files under references/, leaving a short pointer plus only the load-bearing rules (e.g., the IRON RULEs and the input gate) in SKILL.md.

Strip maintainers-only metadata — issue numbers (#849, #134), schema/lint-count tables, operational monitors, and 'v3.x may introduce…' roadmap notes — into references/changelog.md, keeping the body to what a runtime agent must do.

Reconcile the File Structure section with the actual bundle: either include agents/, shared/, scripts/, templates/, and examples/ or rewrite citations of those paths to the bundled references/ equivalents so no pointer dead-ends.

DimensionReasoningScore

Conciseness

The ~660-line body contains multiple heavily padded sections aimed at maintainers rather than runtime execution: the ~90-line 'v3.6.6 Generator-Evaluator Contract Protocol' with its 'Lint count summary' table, 'Operational monitor: track [GENERATOR-PHASE-ABORTED] rate over the first three months', and issue-number annotations ('(#825)', '(#892)', '#849', 'DELEGATE-52') throughout. These are version-history/design-doc material, not instructions, matching 'noticeably verbose; several unnecessary explanations or padded sections' rather than the mostly-efficient anchor 3.

2 / 5

Actionability

There is concrete guidance in the mode table (trigger → agents → output), the 8-phase diagram, checkpoint rules, and the anti-patterns table ('Every citation must be verified via DOI or WebSearch'). But large sections narrate internal mechanisms (contract JSON re-injection, schema field names, lint check counts) without executable steps, and many cited paths are missing from the actual bundle — 'agents/intake_agent.md', 'scripts/check_acronyms.py', 'shared/contracts/writer/full.json', 'templates/revision_tracking_template.md', 'docs/design/2026-05-18-…md' do not exist in references/. This fits 'some concrete guidance but incomplete… missing key details' rather than anchor 4's 'minor gaps'.

3 / 5

Workflow Clarity

The 8-phase orchestration is clearly sequenced ('Phase 0: CONFIG -> [intake_agent] -> Paper Configuration Record') with explicit validation checkpoints ('⚠️ IRON RULE: User must confirm Paper Configuration Record before proceeding to Phase 1', 'Critical-severity issues block progression to Phase 7', 'Max 2 revision loops') and a failure-paths table. Not anchor 5 because the interleaved v3.6.6 contract material and per-mode flows given only as '1->2->3' notation muddy the main flow, and several checkpoint details live in non-bundled files.

4 / 5

Progressive Disclosure

Structure exists — 28 files in references/ match the claimed 'References (28 files in references/)' listing and are signaled with 'See references/… for details'. But the body also points to absent paths (agents/, shared/, scripts/, templates/, examples/, docs/design/) at least 25 times, and inlines content that belongs in those separate files (the full bilingual review-form note '開始回顧之前…' plus its English twin, the routing core repeated from 'shared/references/routing_core.md'). This fits 'some structure… content that should be separate is inline' rather than anchor 4's 'most content is appropriately placed'.

3 / 5

Total

12

/

20

Passed

Description

82%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, third-person description with an exemplary multilingual trigger list that clearly answers both what and when. Its main weakness is compressed feature-shorthand that trades user legibility for density.

DimensionReasoningScore

Specificity

The description enumerates concrete capabilities — '12-agent academic paper writing pipeline', '11 modes (full/plan/outline/…)', '6 paper types, 5 citation formats, bilingual abstracts, LaTeX/DOCX-via-Pandoc/PDF output' — several specific items with only minor gaps, matching anchor 4. Not anchor 5 because the mid-section shorthand 'Style Calibration + Writing Quality Check + Anti-Patterns with IRON RULE markers' is feature-label jargon rather than a concrete, user-legible action, and the individual mode behaviors are only implied by their names.

4 / 5

Completeness

Both what and when are present: the 'what' is '12-agent academic paper writing pipeline' with mode and output enumerations, and the 'when' is an explicit 'Triggers:' list — matching anchor 4. Not anchor 5 because the 'what' is telegraphic spec-shorthand ('6 paper types, 5 citation formats… IRON RULE markers') that answers what the pipeline contains rather than plainly what it does for the user, leaving the capability statement dense rather than clear.

4 / 5

Trigger Term Quality

The 'Triggers:' clause is comprehensive natural-phrase coverage including synonyms and multilingual variants: 'write paper, academic paper, guide my paper, parse reviews, I got reviewer comments, should we push back, conference rebuttal… check citations, verify references, look over the refs' plus Spanish, Traditional Chinese, and Korean equivalents — matching anchor 5's 'comprehensive coverage of natural terms including synonyms' (and exceeding its file-extension example in breadth).

5 / 5

Distinctiveness Conflict Risk

The niche is clear — academic paper writing with dedicated triggers like 'conference rebuttal', 'grant panel response', 'audit my rebuttal' — but broad entries ('write paper', 'check my references', 'verify references') and the skill's own acknowledgment of sibling skills (deep-research, academic-paper-reviewer, academic-pipeline) create minor overlap risk with closely related skills, matching anchor 4 rather than anchor 5's 'minimal conflict risk'.

4 / 5

Total

17

/

20

Passed

Validation

75%

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

Validation — 12 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

skill_md_line_count

SKILL.md is long (663 lines); consider splitting into references/ and linking

Warning

metadata_field

'metadata' should map string keys to string values

Warning

relative_links

Relative link issues: 1 suspicious

Warning

referenced_paths_exist

Referenced path issues: 9 missing

Warning

Total

12

/

16

Passed

Repository

Imbad0202/academic-research-skills

Path

academic-paper/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.