skill-simplify

Simplify SKILL.md documents while preserving functional logic and interfaces.

1|Updated May 12, 2026
One-click install
npx skills add https://github.com/tcytan/tecton --skill skill-simplify
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-simplify
Source: https://github.com/tcytan/tecton/tree/main/.claude/skills/skill-simplify
Command: npx skills add https://github.com/tcytan/tecton --skill skill-simplify

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It reduces redundancy and fixes formatting in a skill’s SKILL.md while guaranteeing functional integrity so the skill continues to behave the same way.

Core Features & Use Cases

  • Functional-first simplification: Preserves functional elements such as logic code blocks, agent calls, data structures, routing branches, and schemas while removing only safely deletable descriptive content.
  • Three-phase workflow: Runs an analysis phase to build a functional inventory, an optimization phase to apply deletion/merge/simplify/format rules, and an integrity check phase to verify counts and detect any losses.
  • Pseudo-code validation: Detects format issues like nested backticks, bracket mismatches, and structural completeness problems, then fixes them during optimization.
  • Quantitative integrity verification: Compares functional inventory baselines before vs. after, failing on critical functional loss and warning when only safe/expected decreases occur.

Quick Start

Use the skill-simplify skill to simplify a target SKILL.md by running it on the file path you want to optimize and then confirm the Phase 3 integrity check passes.

Frequently Asked Questions about skill-simplify

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

FAQPage Schema
How do I simplify markdown documentation without breaking functional logic?

You can simplify markdown documentation without breaking logic by running an inventory-driven refactoring workflow that preserves functional elements like code blocks and schemas while removing only redundant descriptive content.

How do I fix pseudo-code formatting issues like nested backticks and bracket mismatches?

To fix pseudo-code formatting issues, run a validation phase that detects nested backticks, bracket mismatches, and structural completeness problems, then automatically repairs them during the optimization pass.

Can I safely remove redundant text from a multi-phase skill document?

Yes, you can safely remove redundant text by applying prioritized delete, merge, simplify, and format operations that classify role-aware code blocks to ensure functional integrity is maintained throughout the document.

How do I verify functional integrity after refactoring documentation?

You verify functional integrity after refactoring by running a quantitative check that compares the functional inventory baseline before and after optimization, failing on critical functional loss and warning on safe decreases.

What is the best way to optimize yaml frontmatter and routing branches in skill docs?

The best way to optimize yaml frontmatter and routing branches is using a three-phase workflow that builds a functional inventory, applies optimization rules, and executes a baseline integrity check to preserve interfaces.