# Mira Annotation Review

Review MIRA annotations in Markdown documents for semantic correctness, Markdown...

- Repository: https://github.com/stencila/stencila (914 stars)
- Category: Writing
- License: Apache-2.0
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add stencila/stencila --skill mira-annotation-review -g -a claude-code -y`
Codex: `npx skills add stencila/stencila --skill mira-annotation-review -g -a codex -y`
Cursor: `npx skills add stencila/stencila --skill mira-annotation-review -g -a cursor -y`
Gemini CLI: `npx skills add stencila/stencila --skill mira-annotation-review -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add stencila/stencila`

## Description

Review MIRA annotations in Markdown documents for semantic correctness, Markdown dialect validity, preservation, and relation integrity. Use for md, smd, qmd, and myst files containing research objects such as claims, evidence, questions, protocols, requests, typed claims, ids, and relations. Produces actionable findings without modifying files by default.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

## Overview

Review MIRA annotations in Markdown documents without changing the files unless the user explicitly asks for edits. Check that annotated research objects and relations are semantically grounded in the source text, valid for the document's Markdown dialect, internally consistent, and preservative of the original document structure and meaning.

This skill is for annotation quality assurance, not for general prose editing or adding new annotations. Prefer concrete, actionable findings over broad advice.

## Required Inputs

| Input | Required | Description |
|---|---|---|
| Target Markdown content or file path | Required | The annotated Markdown text or one or more `.md`, `.smd`, `.qmd`, or `.myst` files to review |
| Markdown flavor or file extension | Optional | One of Stencila Markdown, Quarto Markdown, MyST Markdown, or plain Markdown; infer from path and syntax when absent |
| Review scope | Optional | Entire document, selected sections, specific annotation ids, or a particular concern such as relation integrity |
| MIRA vocabulary or project conventions | Optional | Any project-specific allowed object types, relation names, id style, or dialect conventions |
| Desired output detail | Optional | Summary only, full finding table, line-referenced findings, or prioritized remediation plan |

When used standalone, these inputs come from the user or the agent's prompt. When used within a workflow, the workflow's stage prompt will specify how to obtain them.

## Outputs

The rest: https://github.com/stencila/stencila/blob/HEAD/.stencila/skills/mira-annotation-review/SKILL.md