skill2gene

Convert document-oriented procedural skills into compact strategy gene control units.

3.9k|388|Updated Dec 6, 2018
One-click install
npx skills add https://github.com/didi/mpx --skill skill2gene
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill2gene
Source: https://github.com/didi/mpx/tree/main/.agents/skills/skill2gene
Command: npx skills add https://github.com/didi/mpx --skill skill2gene

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Traditional procedural skills are document-oriented and consume around 2500 tokens, diluting the behavioral control signals that actually influence model reasoning. This Skill distills them into compact strategy genes of 200-300 tokens based on the Gene Evolution Protocol (GEP), maximizing control signal density per token.

Core Features & Use Cases

  • Skill-to-Gene Distillation: Analyzes a full skill package (SKILL.md, references, scripts), locates sparse control signals in workflow sections, and splits them into atomic genes by functional domain.
  • GEP-Compliant Gene Formatting: Generates genes with standardized metadata headers, strategy-gene tag bodies, ordered strategy steps, and embedded AVOID failure warnings.
  • Coverage Validation: Verifies that distilled genes cover the original skill's effective control signals, meet token budgets, and follow structural conventions.
  • Use Case: Given a verbose 2500-token documentation-style skill, convert it into a registry of 5-7 atomic genes with a GENES.md dispatch table, reducing inference-time token cost while improving behavioral control.

Quick Start

Convert my existing procedural skill in the target directory into a set of compact strategy genes following the GEP protocol.

Frequently Asked Questions about skill2gene

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

FAQPage Schema
How do I convert a procedural skill into strategy genes?

Read the entire skill package, identify control signals concentrated in workflow sections, split them by functional domain into atomic genes, then write each gene with keywords, a one-sentence summary, 3-7 strategy steps, and AVOID warnings. Finish by creating a GENES.md registry and validating coverage.

What is the Gene Evolution Protocol (GEP) format?

GEP defines a gene as an HTML comment metadata header (type, schema_version, id, signals_match) plus a strategy-gene tag body containing domain keywords, summary, and ordered strategy steps with embedded AVOID items. Each gene file targets 200-300 tokens.

Why are strategy genes better than compressed skills?

Research shows genes are not merely shorter skills but a different abstraction: they organize experience as explicit control interfaces rather than documentation. Truncated skills underperform genes, and appending documentation back to genes actually degrades results.

How many tokens should a strategy gene contain?

Each gene should contain 200-300 tokens, which is the empirically validated optimal control budget. Exceeding this dilutes signal density, while falling below it may indicate missing decision constraints.

Should I combine multiple genes for one task?

A single precise gene performs best according to the referenced research. Combining multiple genes, even nominally complementary ones, typically weakens control by splitting attention and blurring the control focus.

When should failure experience be encoded as AVOID warnings?

Encode failure patterns as standalone compact AVOID instructions placed at the end of a gene's strategy list. Independent failure warnings are the most effective encoding form, while mixing them into strategy steps weakens both.