Skip to content

K-Dense-AI/scientific-agent-skills / skills/scientific-writing

scientific-writing

Verified

Drafts, revises, and audits scientific manuscripts or reports with explicit evidence provenance, reporting-guideline coverage, authorship accountability, confidentiality controls, and local consistency checks. Use for manuscript sections, references, declarations, tables, figures, or submission preparation when scientific accuracy and traceability matter.

references/professional_report_formatting.md

View on GitHub
# Safe Formatting for Reports and Manuscripts

## Content before presentation

The former LaTeX style and demonstration report were removed. They could turn
plausible-looking placeholder findings into a polished PDF. This version uses
format-neutral Markdown and JSON/CSV registries so incompleteness remains visible.

Do not format a draft as submission-ready while any verification gate is incomplete.
Visual polish is not evidence.

## Workflow

1. Create a local scaffold.
2. Draft and verify content in Markdown.
3. Run manifest, claim, reference, consistency, authorship, coverage, and lint checks.
4. Obtain accountable human approval.
5. Copy the verified content into the current venue template.
6. Re-run checks that remain applicable and inspect the rendered output manually.

For a journal or conference, use its current author instructions and official template.
For an institutional report or thesis, use the institution's controlled template.

## Fail-closed placeholder policy

Permitted draft markers are intentionally conspicuous, such as `[[TODO:...]]`. The
language linter treats them as errors. Never replace an unresolved marker with generic
boilerplate, a guessed number, a fabricated statement, or an invented citation.

Keep:

- `submission_ready` false;
- the draft banner visible;
- missing declaration statuses explicit;
- human and confidentiality gates incomplete;

until the underlying records are verified.

## Headings and navigation

- Use a single title and logical heading levels.
- Preserve heading order when converting formats.
- Include lists of tables or figures only when useful or required.
- Use stable internal labels for tables, figures, appendices, and supplements.
- Ensure generated bookmarks and reading order match the visible structure.

## Typography and layout

- Use the venue's prescribed font, spacing, margins, page size, and line numbering.
- Do not use color, weight, or position as the only carrier of meaning.
- Keep equations, symbols, units, subscripts, and superscripts intact through
  conversion.
- Check widows, orphans, clipped content, broken links, and misplaced floats manually.

## Tables, figures, and accessibility

Follow `figures_tables.md`. Verify alt text, captions, provenance, permissions, color
independence, reading order, label legibility, and final-size rendering. Do not create a
decorative visual simply to make a report appear complete.

## References and declarations

References must render from verified metadata. After conversion, inspect identifier
links, special characters, author order, and citation order.

Declarations must come from validated records. A style template must never supply a
default ethics approval, consent statement, funding source, conflict statement, author
contribution, data or code promise, or AI disclosure.

## Archival handoff

Retain:

- the verified Markdown source;
- the structured registries;
- the exact venue template version;
- conversion instructions and software versions;
- the final rendered file;
- validator outputs and human approval record.

Do not archive sensitive source documents alongside a public manuscript package unless
authorization, consent, law, contracts, and policy permit it.
rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first.Stars: 194kUpdated Claude CodeCodexVerifiedInstall