oversized-skill

Detect oversized SKILL.md files and trigger size warnings during validation.

3|Updated Dec 27, 2025
One-click install
npx skills add https://github.com/princespaghetti/skset --skill oversized-skill
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: oversized-skill
Source: https://github.com/princespaghetti/skset/tree/main/test/fixtures/oversized-skill
Command: npx skills add https://github.com/princespaghetti/skset --skill oversized-skill

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill detects oversized SKILL.md files and triggers a size-warning during skill validation, helping maintain concise, maintainable skill definitions.

Core Features & Use Cases

  • Oversize detection: flags SKILL.md files that exceed the recommended length, guiding you to split content into references or assets.
  • Maintainability: promotes readable, documented skills and prevents bloated frontmatter.
  • Use Case: In a large library, run this check to identify skills where the description or body surpasses the allowed size and refactor accordingly.

Quick Start

Check whether SKILL.md exceeds the maximum allowed length and return a warning if it does.

Frequently Asked Questions about oversized-skill

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I check if a SKILL.md file is oversized during validation?

Checking if a SKILL.md file is oversized during validation involves running a skill validation check that measures file length. This triggers a size warning when the body exceeds the recommended length, guiding you to refactor and maintain concise documentation.

What happens when a SKILL.md file exceeds the allowed length?

When a SKILL.md file exceeds the allowed length, the validation process triggers a size warning. This flags the oversized file and prompts you to refactor by splitting bloated content into separate references or assets to maintain readability.

Why does SKILL.md validation fail with a size warning?

SKILL.md validation triggers a size warning because the file body has surpassed the maximum allowed length. This prevents bloated frontmatter and maintainability issues by flagging the specific file that requires content reduction.

What is the best way to handle bloated SKILL.md files in a large repository?

The best way to handle bloated SKILL.md files in a large repository is to run an oversize detection check. This identifies skills surpassing the allowed size so you can refactor the documentation and split content into references or assets.

Do I need extra tooling to detect oversized SKILL.md files?

Detecting oversized SKILL.md files requires minimal tooling. The validation process checks the file length directly and returns a warning if it exceeds the recommended size, eliminating the need for complex external dependencies.