karuhi
- 11 skills
- 0 followers
- 1 day ago last updated
- ▌
- ▌ Ordito Generate · karuhi bundleExplicitly (re)generate Ordito HTML pages from IR + template contract + collection, and stamp meta.generated_at. This is the heavy, explicit "反映（再生成）" step — run it ONLY after the user has agreed to reflect changes (e.g. "反映しますか？" → yes). It can regenerate everything, only specific page ids, or only stale pages (only:"stale"). It MUST NOT be run as a side effect of updating IR — updating (ordito-update-block) never triggers generation (spec §5.4). The calling agent owns the confirmation; this skill just generates and returns a report.
- ▌ Ordito Validate · karuhi bundleValidate Ordito IR documents and/or generated HTML against the spec's machine checks (§6.1) — JSON Schema conformance of the IR, field_map coverage (unmapped-field detection, §4.4), and, if an output dir is given, the generated fragment's allowed-class/tag/attribute compliance plus a deterministic IR-fidelity check. Read-only. Use it to confirm quality before recording a change or after regenerating (反映前後の品質確認). Returns a JSON report; does not fix or confirm anything.
- ▌ Ordito Add Block · karuhi bundleInsert a NEW block into an existing Ordito IR document. Use this when the user has agreed to add a new piece of content (a paragraph, code sample, note, table, step, etc.) to a page that already exists — as opposed to editing an existing block (ordito-update-block) or creating a whole new page (ordito-create-page). Inserts the block at append/at/after/before a sibling, or inside a tab, auto-assigns a unique block id if omitted, validates the result, and bumps meta.updated_at. Does NOT regenerate HTML (ordito-generate is separate) and does NOT ask for confirmation; the calling agent owns that.
- ▌ Ordito Move Block · karuhi bundleReorder or re-parent an existing block within an Ordito IR document (write to the IR store). Use this when the user wants to change the ORDER of content on a page, or move a block into/out of a tab — without changing the block's content. Moves exactly one existing block by id to a new position (at/after/before a sibling, or inside a tab), validates the result, and bumps meta.updated_at. Does NOT regenerate HTML (ordito-generate is separate) and does NOT ask for confirmation; the calling agent owns that.
- ▌ Ordito Create Page · karuhi bundleCreate a NEW Ordito IR document (a new docs page) in the IR store. Use this when the user has agreed to add a brand-new page to the docs (not edit an existing one) — e.g. "新しいページを作る" / "○○のガイドを追加". Writes one new IR document by logical id, sets meta.title and meta.updated_at, leaves generated_at null, and can optionally place the page into the collection nav in the same call. Refuses if the id already exists or is the reserved "index". Does NOT regenerate any HTML (generation is the separate ordito-generate step) and does NOT ask for confirmation itself; the calling agent owns that decision.
- ▌ Ordito Delete Page · karuhi bundleDelete a whole Ordito IR document (page) from the store. Use this when the user has agreed to remove an entire page from the docs. Deletes the IR file and, by default, also removes the page's entry from the collection nav (pruning now-empty groups). Already-generated out/<id>.html is NOT deleted (it just stops being regenerated) — the skill notes this. Does NOT regenerate HTML (ordito-generate is separate) and does NOT ask for confirmation itself; the calling agent owns that decision.
- ▌ Ordito Detect Stale · karuhi bundleList Ordito IR documents whose content has changed since their last HTML generation (updated_at is newer than generated_at, or never generated). Read-only; touches nothing. Use this to gather material for asking the user "未反映が N 件あります。反映（再生成）しますか？" before deciding whether to run ordito-generate. Returns a JSON list of stale pages with their timestamps. Does not generate, does not confirm — the calling agent presents the result and asks.
- ▌ Ordito Remove Block · karuhi bundleDelete one block from an existing Ordito IR document (write to the IR store). Use this when the user has agreed to remove a specific piece of content from a page — a now-obsolete note, paragraph, code sample, etc. Removes exactly one block by id (including blocks nested inside tabs), validates the remaining document, and bumps meta.updated_at. Does NOT regenerate HTML (ordito-generate is the separate step) and does NOT ask for confirmation itself; the calling agent owns that decision.
- ▌
- ▌