How do I install the Shard skill?

Run npx skillmds@latest add vbrevik/shard in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

What does the Shard skill do?

Use when the user says 'shard this', 'split file', or when working with files over 1000 lines. It is listed under Coding & Dev Tools on SkillMD.

Is Shard safe to use?

This skill has not completed SkillMD's automated safety review yet. Capability flags: docs only. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Shard?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Shard free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

vbrevik (@vbrevik) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Shard by vbrevik — Agent Skill

Name: Shard
Rating: 4.5 (4 reviews)
Author: vbrevik

File contents

💎 Shard — Refactoring Large File...

Split monolithic files into focused, maintainable modules.

Activation

When this skill activates, output:

💎 Shard — Refactoring large file...

Then execute the protocol below.

Context Guard

Context	Status
User says "shard", "split file", or "refactor"	ACTIVE — full protocol
Editing a file over 1000 lines	ACTIVE — suggest refactor
User says "refactor" for logic changes (not splitting)	DORMANT — not a shard task
Discussing code organization concepts	DORMANT — do not activate
File is under 500 lines	DORMANT — not worth splitting

Protocol

Identify the target file and count lines:
```
wc -l <file>
```
Analyze structure:
- List all exports (functions, components, types, constants)
- Identify logical groupings
- Map internal dependencies (what calls what)
Propose the split — present to user BEFORE executing:
- Target: 100-300 lines per new file
- Group related functionality
- Keep types near consumers
- Shared utilities in separate file
Execute the refactor:
- Create new files with proper names
- Move code to appropriate files
- Add import/export statements
- Create index.ts barrel if needed for backwards compatibility
- Update all imports throughout the project
Verify build:
```
npm run build 2>&1 | tail -20
```
Present result — new file structure with line counts

Inputs

File path to refactor
Optional: preferred split strategy or target file count

Outputs

Multiple smaller files replacing the original
Updated imports throughout project
Build verification

Example Usage

User: "shard infrastructure/page.tsx — it's 1100 lines"

💎 Shard — Refactoring large file...

infrastructure/page.tsx (1,110 lines) → 6 files:
  page.tsx         (~120 lines) — Main page, tab switcher
  RailwayTab.tsx   (~200 lines) — Railway monitoring
  HetznerTab.tsx   (~180 lines) — Hetzner monitoring
  HeadroomTab.tsx  (~250 lines) — Headroom + setup guide
  types.ts         (~80 lines)  — Shared interfaces
  constants.ts     (~60 lines)  — Status configs

Build check: ✓ passed

Level History

Lv.1 — Base: File analysis and splitting with import updates. (Origin: MemStack v1.0, Feb 2026)
Lv.2 — Enhanced: Added YAML frontmatter, context guard, propose-before-execute, activation message. (Origin: MemStack v2.0 MemoryCore merge, Feb 2026)

---name: sharddescription: Use when the user says 'shard this', 'split file', or when working with files over 1000 lines.---# 💎 Shard — Refactoring Large File...*Split monolithic files into focused, maintainable modules.*## ActivationWhen this skill activates, output:`💎 Shard — Refactoring large file...`Then execute the protocol below.## Context Guard| Context | Status ||---------|--------|| **User says "shard", "split file", or "refactor"** | ACTIVE — full protocol || **Editing a file over 1000 lines** | ACTIVE — suggest refactor || **User says "refactor" for logic changes (not splitting)** | DORMANT — not a shard task || **Discussing code organization concepts** | DORMANT — do not activate || **File is under 500 lines** | DORMANT — not worth splitting |## Protocol1. **Identify the target file** and count lines: ```bash wc -l <file> ```2. **Analyze structure:** - List all exports (functions, components, types, constants) - Identify logical groupings - Map internal dependencies (what calls what)3. **Propose the split** — present to user BEFORE executing: - Target: 100-300 lines per new file - Group related functionality - Keep types near consumers - Shared utilities in separate file4. **Execute the refactor:** - Create new files with proper names - Move code to appropriate files - Add import/export statements - Create index.ts barrel if needed for backwards compatibility - Update all imports throughout the project5. **Verify build:** ```bash npm run build 2>&1 | tail -20 ```6. **Present result** — new file structure with line counts## Inputs- File path to refactor- Optional: preferred split strategy or target file count## Outputs- Multiple smaller files replacing the original- Updated imports throughout project- Build verification## Example Usage**User:** "shard infrastructure/page.tsx — it's 1100 lines"```💎 Shard — Refactoring large file...infrastructure/page.tsx (1,110 lines) → 6 files: page.tsx (~120 lines) — Main page, tab switcher RailwayTab.tsx (~200 lines) — Railway monitoring HetznerTab.tsx (~180 lines) — Hetzner monitoring HeadroomTab.tsx (~250 lines) — Headroom + setup guide types.ts (~80 lines) — Shared interfaces constants.ts (~60 lines) — Status configsBuild check: ✓ passed```## Level History- **Lv.1** — Base: File analysis and splitting with import updates. (Origin: MemStack v1.0, Feb 2026)- **Lv.2** — Enhanced: Added YAML frontmatter, context guard, propose-before-execute, activation message. (Origin: MemStack v2.0 MemoryCore merge, Feb 2026)

Frequently asked questions

Shard