Skip to content

MuharremTozan/Agentic-Duel / .agent/skills/skill-creator

skill-creator

Verified

Guide for creating effective skills. This skill should be used when users want to create a new skill (or update an existing skill) that extends Claude's capabilities with specialized knowledge, workflows, or tool integrations.

FileKindSize
LICENSE.txtmarkdown11.1 KB
SKILL.mdskill md18.2 KB
references/hybrid-design.mdmarkdown1.9 KB
references/output-patterns.mdmarkdown1.8 KB
references/workflows.mdmarkdown818 B
scripts/init_skill.pyscript10.6 KB
scripts/package_skill.pyscript3.2 KB
scripts/quick_validate.pyscript3.9 KB

references/hybrid-design.md

View on GitHub
# Bi-directional Hybrid Design Principle

This guide explains how to design skills that scale from simple to complex usage without sacrificing clean architecture or overwhelming the user with boilerplate.

## 1. The Strategy: Bi-directional Generation

When designing assets (code, logic, or templates) for a skill, always provide two "directions" of implementation:

### A. The "Pro" Path (Complex/Large Tasks)
- **Target**: Multi-file, long-term, high-complexity systems.
- **Pattern**: Industry-standard, decoupled, SOLID-compliant.
- **Example**: A Finite State Machine where every state is its own class and file for maximum isolation.
- **Trigger**: Used when the logic is very dense, requires many internal variables, or will be modified by multiple developers.

### B. The "Light" Path (Simple/Single-Use Tasks)
- **Target**: Single-script, fast-prototyping, low-repetition tasks.
- **Pattern**: Simplified, integrated, lambda-based, or monolithic.
- **Example**: A `LambdaState` that allows defining behavior in a single line of code within an existing script.
- **Trigger**: Used when creating a full file would be "boilerplate overkill."

## 2. Hybrid Usage in Practice
A great skill allows **Hybrid Usage**—where both Pro and Light paths coexist in the same project.

**Example: State Machine**
- Use **Pro classes** for the *Player Controller* (Complex movement, wall-climbing, physics).
- Use **Light lambdas** for a *Simple Door* (Idle, Open, Closed).

## 3. Implementation Recommendations
When building templates for a skill:
- **Interfaces are the Bridge**: Ensure your "Light" and "Pro" versions implement the same interface. This allows them to be mixed in the same collection (e.g., a List of States containing both classes and lambdas).
- **Namespaces**: Keep namespaces flexible or use placeholders.
- **Progressive Discovery**: Put the "Light" example at the top of the guide for fast success, and link to the "Pro" patterns under an "Advanced" section.
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 322kUpdated Claude CodeCodexVerifiedInstall