skills.rest
openyida
openyidaOFFICIAL
Explore all skills by this author →
GitHub

skill-optimization-guide

Reduce SKILL.md files under 200 lines by extracting code into references.

201|43|Updated Mar 5, 2026
Search Tags:#documentation#optimization#references#samples#skill-md#yida
One-click install
npx skills add https://github.com/openyida/openyida --skill skill-optimization-guide
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: skill-optimization-guide
Source: https://github.com/openyida/openyida/tree/main/.qoder/skills/skill-optimization-guide
Command: npx skills add https://github.com/openyida/openyida --skill skill-optimization-guide

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Provides a disciplined workflow to condense and reorganize verbose or redundant SKILL.md files so that the entry document becomes a concise, navigable "navigation hub" while preserving all original content in referenced files.

Core Features & Use Cases

  • Line-count reduction: Identify SKILL.md files exceeding 200 lines and reduce them by extracting long code examples and detailed specifications into references or samples.
  • Duplication elimination: Detect and merge repeated sections into a single "core rules" chapter to minimize overlap and improve readability.
  • Safe extraction & linking: Move full implementations to samples, keep skeletons or summaries in references, and insert persistent reference links back into the SKILL.md; includes a verification checklist to ensure no information loss.
  • Use Case: When a skill package contains repeated rules and inline templates, apply this guide to produce an entry SKILL.md under 200 lines with all full examples relocated to references and samples.

Quick Start

Run a targeted optimization: reduce SKILL.md to under 200 lines, extract full code blocks into references or samples, and add in-place reference links for every extracted section.

Frequently Asked Questions about skill-optimization-guide

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

FAQPage Schema
How do I reduce a SKILL.md file that exceeds 200 lines?▼

To reduce a SKILL.md file exceeding 200 lines, extract embedded full code examples and detailed specifications into references or samples files. This restructures the document into a concise navigation hub while preserving original content via persistent relative links.

What is the best way to reorganize repeated sections in documentation?▼

The best way to reorganize repeated sections in documentation is to detect and merge duplicated content into a single core rules chapter. This minimizes overlap and significantly improves overall document readability and navigability.

How do I move inline code templates to references without losing information?▼

Move inline code templates to references by relocating full implementations to samples and keeping summaries in references. Insert persistent reference links back into the SKILL.md and use a verification checklist to ensure zero information loss.

When should I restructure a skill package entry document?▼

You should restructure a skill package entry document when it contains verbose content, repeated chapters, or inline templates. Condensing these elements creates a navigable hub and improves the document's overall readability and structure.

Does extracting code examples to samples break relative links?▼

Extracting code examples to samples does not break relative links if persistent reference links are correctly inserted back into the SKILL.md. A final verification checklist ensures all relative links are valid and functional.

Related Skills

Explore More Software Engineering Skills→
ntluong95ntluong95

Workflow Writing Standard

Enforce conciseness and token efficiency in workflow and skill file creation.

Community
Basic
NSEvteevNSEvteev
31

links-validate

Validate and fix broken links between Markdown documents.

Community
Intermediate
nashirabbashnashirabbash

write-api-reference

Generate MDX API reference pages for Next.js APIs from source or specifications.

Community
Advanced
sandgardenhqsandgardenhq
130

markdown-navigation

Generate hierarchical outlines and extract sections from markdown files using bash utilities.

Official
Basic