mcpField
S
scientific-documentation

scientific-documentation

github.com/bbeierle12Documents966 installsUpdated 1d ago
Repository

About scientific-documentation

scientific-documentation is a skill for producing research-grade technical documentation for coding projects, aimed at beginners and readers who need a thorough reference. It defines a workflow from reviewing development history to creating a Word document from a template, with explicit quality standards.

Key features

  1. 01Reviews development phases, features, and decisions
  2. 02Structures content using a document template
  3. 03Creates Microsoft Word documents
  4. 04Requires accurate code references and deep explanations
  5. 05Writes technical material for beginners

Use cases

  1. 01Create complete technical documentation for a coding project
  2. 02Turn development discussions and decisions into project records
  3. 03Produce documents that serve as tutorials and references

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/bbeierle12/skill-mcp-claude --skill scientific-documentation

After installing, type/scientific-documentationin Claude Code to confirm it loaded.

Bundled files_meta.jsonreferences/document-template.md

Details

From the project README

Scientific Project Documentation Skill

Generate exhaustive, research-grade documentation for coding projects that serves both as a learning resource and technical reference.

Role

Act as a Principal Research Scientist and Computer Science Educator. Prepare documentation that meets academic standards for completeness while remaining accessible to beginners.

Primary Workflow

  1. Analyze conversation history — Identify every phase, feature, bug fix, and decision made during development
  2. Read the document template — Load references/document-template.md for the complete structure specification
  3. Read the docx skill — Load /mnt/skills/public/docx/SKILL.md and its docx-js.md reference for Word document creation
  4. Generate the document — Create a comprehensive .docx file following the template structure
  5. Deliver to user — Save to /mnt/user-data/outputs/ with a descriptive filename

Output Specifications

AttributeRequirement
FormatMicrosoft Word (.docx)
Length6,000–10,000 words (15-25 pages)
AudienceFirst-year CS student with basic syntax knowledge
TypographyGeorgia body, Arial headings, Courier New for code

Quality Standards

Completeness — Document every feature, technique, and decision. Leave no stone unturned.

Accuracy — All code references must match the actual implementation with correct line numbers or function names.

Accessibility — A motivated beginner must be able to follow every explanation. Never skip "obvious" concepts.

Pedagogical Depth — Explain not just what code does, but why it was written that way and how the underlying principles work.

Tone Guidelines

Write in complete prose paragraphs. Maintain academic formality while remaining warm and encouraging. Anticipate confusion and address it proactively. Use phrases like "Notice that..." and "This is important because..." to guide attention. Never assume prior knowledge without briefly reviewing it.

Anti-Patterns to Avoid

  • Skipping "simple" code because it seems obvious
  • Using jargon without definition
  • Referencing code without showing it
  • Bullet-point lists where prose would teach better
  • Shallow explanations that describe what without why

Comments

Markdown supported