MuharremTozan/Agentic-Duel / .agent/skills/skill-creator
skill-creator
VerifiedGuide 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.
| File | Kind | Size |
|---|---|---|
| LICENSE.txt | markdown | 11.1 KB |
| SKILL.md | skill md | 18.2 KB |
| references/hybrid-design.md | markdown | 1.9 KB |
| references/output-patterns.md | markdown | 1.8 KB |
| references/workflows.md | markdown | 818 B |
| scripts/init_skill.py | script | 10.6 KB |
| scripts/package_skill.py | script | 3.2 KB |
| scripts/quick_validate.py | script | 3.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.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| 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: 472k | Updated | Claude CodeCodex | Verified | Install |
| 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: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| 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 available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |