ReddRadar
Agent skill
shirushi
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.
Install this agent skill to your Project
npx add-skill https://github.com/aiskillstore/marketplace/tree/main/skills/caphtech/shirushi
SKILL.md
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.
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
aiskillstore/marketplace
perigon-backend
Perigon ASP.NET Core + EF Core + Aspire conventions
aiskillstore/marketplace
perigon-agent
Pointers for Copilot/agents to apply Perigon conventions
aiskillstore/marketplace
perigon-angular
Angular 21+ standalone/Material/signal conventions for Perigon WebApp
aiskillstore/marketplace
fastapi-mastery
Comprehensive FastAPI development skill covering REST API creation, routing, request/response handling, validation, authentication, database integration, middleware, and deployment. Use when working with FastAPI projects, building APIs, implementing CRUD operations, setting up authentication/authorization, integrating databases (SQL/NoSQL), adding middleware, handling WebSockets, or deploying FastAPI applications. Triggered by requests involving .py files with FastAPI code, API endpoint creation, Pydantic models, or FastAPI-specific features.
aiskillstore/marketplace
context7-efficient
Token-efficient library documentation fetcher using Context7 MCP with 86.8% token savings through intelligent shell pipeline filtering. Fetches code examples, API references, and best practices for JavaScript, Python, Go, Rust, and other libraries. Use when users ask about library documentation, need code examples, want API usage patterns, are learning a new framework, need syntax reference, or troubleshooting with library-specific information. Triggers include questions like "Show me React hooks", "How do I use Prisma", "What's the Next.js routing syntax", or any request for library/framework documentation.
aiskillstore/marketplace
browser-use
Browser automation using Playwright MCP. Navigate websites, fill forms, click elements, take screenshots, and extract data. Use when tasks require web browsing, form submission, web scraping, UI testing, or any browser interaction.
Didn't find tool you were looking for?