CtrlK
BlogDocsLog inGet started
Tessl Logo

researchwrite

Compose, revise, or audit research proposals, opening reports, and research plans from supporting evidence. Use for 研究计划、开题报告、科研项目申请书. Invoked as researchwrite for compatibility; use nature-writing for general manuscript sections.

68

Quality

86%

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

SKILL.md
Quality
Evals
Security

Quality

Content

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

A well-structured orchestration skill body: lean, mode-dispatched, with an unusually clear QA pipeline that includes ordering rationale, thresholds, bounded retries, and stop rules. The main defects are dangling routing paths (`manifest.yaml`, `templates/`) that point at files not present in the bundle and a small amount of duplicated routing information between the mode table and the reference index.

Suggestions

Fix the dangling routing references: either add `manifest.yaml` and `templates/` to the bundle or rewrite lines 17 and 62 to route directly through the existing `references/project-structure.md` index.

Deduplicate the 模式分派 table and the Reference 文件索引 — keep mode selection in the dispatch table and let the index table carry only the load conditions, trimming the repeated file paths.

Mention `scripts/build_proposal_docx.py` (or route to it via references/export-archive.md) so the export step has a discoverable executable path in the skill.

DimensionReasoningScore

Conciseness

The body is dense and assumes competence — terse numbered principles, tables, and a compact pipeline diagram with no explanations of concepts Claude already knows. Minor trimming is possible (the 模式分派 table repeats reference paths already listed in the Reference 文件索引), so it fits the 4 anchor 'efficient; minor instances that could be trimmed' rather than the 5 anchor's every-token-earns-its-place.

4 / 5

Actionability

Concrete guidance throughout: an exact project file layout with per-file purposes, a decision table mapping inputs to modes, numeric QA thresholds (7.0/5.0), and quoted example user utterances. It falls short of 5 because the primary 9-step compose/revise flows are only pointed to, and the body's routing step "先读取 manifest.yaml" names a file that does not exist in the bundle, so a reader following it verbatim would stall.

4 / 5

Workflow Clarity

The QA pipeline is explicitly sequenced (Gate 2 → 1 → 3 → 4) with a stated rationale for the ordering, per-gear thresholds, and a bounded feedback loop ("总分<阈值 → 按低分维度定向回退(不超过 3 轮)") plus stop rules, matching the 5 anchor's clear sequence with validation steps and error-recovery loops. No destructive/batch operation is involved, so the ≤3 cap does not apply.

5 / 5

Progressive Disclosure

Structure is excellent — an overview body with a 20-row reference index giving per-file load conditions, all of which exist in references/ and are one level deep, matching the 5 anchor's pattern. However, two body instructions route through `manifest.yaml` and `templates/` ("按 manifest.yaml 的 templates.on_demand 路由从 templates/ 取空模板"), which are absent from the bundle, and scripts/build_proposal_docx.py is never mentioned — real navigation gaps that hold it at 4.

4 / 5

Total

17

/

20

Passed

Description

87%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 bilingual description: it answers both what and when with concrete trigger phrases in two languages, and explicitly routes general manuscript work away to a sibling skill. Coverage of capabilities is good but not exhaustive of what the body actually supports, keeping specificity and trigger coverage at the 4 level.

DimensionReasoningScore

Specificity

"Compose, revise, or audit research proposals, opening reports, and research plans" lists three concrete verbs applied to three named artifact types, matching the 'several specific actions; minor gaps in coverage' anchor. It stops short of the 5 anchor's comprehensiveness — QA pipeline modes, review-paper support, and handoff-brief generation covered in the body are absent from the description.

4 / 5

Completeness

The 'what' is explicit ("Compose, revise, or audit research proposals...") and the 'when' is an explicit trigger clause with concrete phrases ("Use for 研究计划、开题报告、科研项目申请书"), satisfying the 5 anchor's both-what-and-when-with-concrete-triggers requirement; the 'Use for' clause also avoids the ≤3 cap for missing trigger guidance.

5 / 5

Trigger Term Quality

Natural terms are present bilingually ("research proposals", "opening reports", "research plans", plus 研究计划、开题报告、科研项目申请书), which is good keyword coverage with synonyms. A few natural terms users would say are missing (e.g., grant application/标书, proposal draft/修改意见), so it sits at the 4 anchor rather than 5's comprehensive coverage.

4 / 5

Distinctiveness Conflict Risk

The closing sentence "use nature-writing for general manuscript sections" actively demarcates the boundary with the closest related skill, and the niche (proposal/plan writing from supporting evidence, not general manuscripts) has distinct triggers, matching the 5 anchor's clear-niche-minimal-conflict example.

5 / 5

Total

18

/

20

Passed

Validation

87%

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

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

metadata_field

'metadata' should map string keys to string values

Warning

Total

14

/

16

Passed

Repository
Yuan1z0825/nature-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.