spec-author

Edit Open Document Spec modules under specs/{ods,okf,skills}. Use when changing normative or author-facing dialect docs, renames, or reading maps.

Jump to install

Repository: open-doc-spec/ods
Last source activity: August 4, 2026 at 09:46
Detected SKILL.md language: English
Stars: 4
Forks: 2

Install options

The review-first prompt is selected by default. You can switch to a direct command or download a local copy.

Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.

A direct command skips the review prompt. Inspect the source before running it.

npx skills add https://github.com/open-doc-spec/ods --skill spec-author

The command stays on one line. Scroll horizontally to inspect it before copying.

Prefer a local copy? Download the files currently available to SkillsMP.

Review the source files

Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.

SKILL.md

Source instructions · Read-only preview

Back to search Back to installation

name	spec-author
description	Edit Open Document Spec modules under specs/{ods,okf,skills}. Use when changing normative or author-facing dialect docs, renames, or reading maps.

Spec author (maintainer)

Layout

specs/
  index.ods.md
  ods/   intro keys core profiles graph context indexes assets validation scope
  okf/   intro keys
  skills/ intro keys

Rules

Read specs/ods/intro.md and keys.md before inventing frontmatter.
Keep one idea per file. Do not re-dump the full key table into core.md.
ODS voice:
- intro — plain language for end users
- keys — dictionary + examples
- core / others — precise; RFC 2119 where normative
Link with relative paths inside the dialect folder.
After edits, grep for dead paths (SPEC.md, non-goals, resources-and-code, flat /spec/graph).
Sync skill copies under skills/ods/references/ when ODS intro/keys/core/scope change.
Update app-web nav + sitemap.xml.ts + redirects in astro.config.mjs if routes change.

Checklist

File name is one word and matches content
Frontmatter order / description set for site sorting
Indexes (index.ods.md) list new children
If keys changed: update src/ods-core/src/spec/schema.rs in the same PR (registry is engine SoT)
Sync skills/ods/references/ when ODS intro/keys/core/scope change
CHANGELOG Unreleased note

spec-author

Source facts

Install options

Review the source files

More from this repository

Spec author (maintainer)

Layout

Rules

Checklist

More from this repository

Spec author (maintainer)

Layout

Rules

Checklist