Shirushi

Skill aiskillstore/marketplace/skills/caphtech/shirushi

Security-audited skills for Claude, Codex & Claude Code. One-click install, quality verified.

Install

npx -y skills add aiskillstore/marketplace --skill shirushi

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

no licenseNo license file was found in the repository. Code published without one is not open source by default, so using it at work is a question for whoever answers licensing questions where you are.

What its author says it does

Copied from the file, not written here

Document ID management for Git repositories. Validates, assigns, and tracks immutable doc_ids across Markdown/YAML files. Use when working with doc_id, document IDs, "@see docid" references, document integrity validation, or shirushi commands.

SKILL.md

1.9 KB, 475 tokens by cl100k_base, as published. Nobody here has run it

Shirushi - Document ID Manager

Shirushi ensures consistent, immutable document IDs across Git repositories with CI integration.

Commands

Command	Purpose
`shirushi lint`	Validate doc_ids and index integrity
`shirushi scan`	List documents with metadata
`shirushi show <id>`	Get document info by doc_id
`shirushi assign`	Assign IDs to new documents
`shirushi rehash`	Recalculate content hashes

Common Workflows

Validate before commit

shirushi lint --base HEAD~1

Find document by ID

shirushi show PCE-SPEC-2025-0001-G

Add doc_id to new document

shirushi assign docs/new-spec.md

List all documents

shirushi scan --format table

Check for changes in PR

shirushi lint --base origin/main --check-references

Configuration

Configuration is defined in .shirushi.yml:

id_format: "{COMP}-{KIND}-{YEAR4}-{SER4}-{CHK1}"
dimensions:
  COMP:
    type: enum
    values: ["API", "UI", "DB"]
  KIND:
    type: enum_from_doc_type
    mapping:
      spec: SPEC
      adr: ADR
  YEAR4:
    type: year
    digits: 4
  SER4:
    type: serial
    digits: 4
    scope: ["COMP", "KIND", "YEAR4"]
  CHK1:
    type: checksum
    algorithm: mod26AZ
    digits: 1

Document Format

Documents use YAML frontmatter:

---
doc_id: API-SPEC-2025-0001-G
title: API Specification
doc_type: spec
---

# Content here...

@see docid References

Reference documents in code comments:

// @see API-SPEC-2025-0001-G
function handleRequest() { ... }

Shirushi tracks these references and warns when referenced documents change.