commit-like-pro: Skill for Claude Code

.claude/skills/bmad-shard-doc/SKILL.md

bmad-shard-doc is a skill for Claude Code from jeffrey2423/commit-like-pro. It costs 34 tokens per session (929 once invoked), scanned A, a copy of bmad-shard-doc, MIT.

A command guide for splitting a large Markdown document into smaller files based on its level-two headings. Markdown is a plain-text format commonly used for documentation.

In plain words
What is it for?
Use it when the user asks to shard a Markdown document into organized section files using the markdown-tree-parser tool.
Why use it?
It provides a fixed process for checking the source file, choosing the destination folder, and stopping when required information or files are missing. This prevents incomplete or misplaced document splits.

Skill for Claude Code

Written for Claude Code: installed under .claude/.

This is jeffrey2423/commit-like-pro's own configuration. It tells Claude Code how to work on commit-like-pro itself, so it is not a mod to install elsewhere. Copy it as a starting point and replace the rules that are about this project. Everything commit-like-pro configures →

Reuse

Borrowing it

Nothing to install: this file belongs to jeffrey2423/commit-like-pro. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.

Copy the file
curl -O https://raw.githubusercontent.com/jeffrey2423/commit-like-pro/main/.claude/skills/bmad-shard-doc/SKILL.md
Clone the repo
git clone --depth 1 https://github.com/jeffrey2423/commit-like-pro

Made for: Claude Code.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for bmad-shard-doc

README.md
[![agentmods](https://agentmods.dev/badge/skills/jeffrey2423/commit-like-pro/bmad-shard-doc.svg)](https://agentmods.dev/skills/jeffrey2423/commit-like-pro/bmad-shard-doc)
Your own site
<a href="https://agentmods.dev/skills/jeffrey2423/commit-like-pro/bmad-shard-doc"><img src="https://agentmods.dev/badge/skills/jeffrey2423/commit-like-pro/bmad-shard-doc.svg" alt="Measured on agentmods" height="20"></a>
Per session 34 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 929 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin 100% copy Near-identical to another mod in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00034 $0.00929
Opus 5 $0.00017 $0.00464
Sonnet 5 $0.00007 $0.00186
Haiku 4.5 $0.00003 $0.00093

Measured 7d ago against content hash 3a1538536514, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-07, from the pricing page.

Security

Grade A, and why

bmad-shard-doc scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 7d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

Origin

This is a copy

100% identical to bmad-shard-doc — 0 lines differ, which has more behind it and is treated as the original. This page carries a canonical link to it rather than competing with it.

.claude/skills/bmad-shard-doc/SKILL.md · 106 lines

How it starts

The opening of the file, as written. The whole thing — 106 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Shard Document

Goal: Split large markdown documents into smaller, organized files based on level 2 sections using npx @kayvan/markdown-tree-parser.

CRITICAL RULES

  • MANDATORY: Execute ALL steps in the EXECUTION section IN EXACT ORDER
  • DO NOT skip steps or change the sequence
  • HALT immediately when halt-conditions are met
  • Each action within a step is a REQUIRED action to complete that step

EXECUTION

Step 1: Get Source Document

  • Ask user for the source document path if not provided already
  • Verify file exists and is accessible
  • Verify file is markdown format (.md extension)
  • If file not found or not markdown: HALT with error message

Step 2: Get Destination Folder

  • Determine default destination: same location as source file, folder named after source file without .md extension
    • Example: /path/to/architecture.md --> /path/to/architecture/
  • Ask user for the destination folder path ([y] to confirm use of default: [suggested-path], else enter a new path)
  • If user accepts default: use the suggested destination path
  • If user provides custom path: use the custom destination path
  • Verify destination folder exists or can be created
  • Check write permissions for destination
  • If permission denied: HALT with error message

Step 3: Execute Sharding

  • Inform user that sharding is beginning
  • Execute command: npx @kayvan/markdown-tree-parser explode [source-document] [destination-folder]
  • Capture command output and any errors
  • If command fails: HALT and display error to user

Step 4: Verify Output

  • Check that destination folder contains sharded files
  • Verify index.md was created in destination folder
  • Count the number of files created
  • If no files created: HALT with error message

Step 5: Report Completion

  • Display completion report to user including:
    • Source document path and name
    • Destination folder path
    • Number of section files created
    • Confirmation that index.md was created
    • Any tool output or warnings
  • Inform user that sharding completed successfully

Read the full file on GitHub · 106 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 7d ago First seen · 106 lines · 34 tokens per session scan A 3a1538536514

Subscribe to this mod's changes

bmad-shard-doc is a skill published in the GitHub repository jeffrey2423/commit-like-pro (2 stars, last pushed 1mo ago), licensed MIT. It adds 34 tokens to every session and 929 once invoked, about $0.0002 per session on Opus 5. A static security scan graded it A with 0 findings. It is 100% identical to bmad-shard-doc, differing in 0 lines, and is treated as a copy.