Skill Creator

#!/usr/bin/env python3

"""

Skill Initializer - Creates a new skill from template



Usage:

    init_skill.py <skill-name> --path <path> [--resources scripts,references,assets] [--examples]



Examples:

    python init_skill.py my-new-skill --path ./workspace/skills

    python init_skill.py api-helper --path ./workspace/skills --resources scripts,references

    python init_skill.py custom-skill --path ./workspace/skills --resources scripts --examples

"""



import argparse

import re

import sys

from pathlib import Path



MAX_SKILL_NAME_LENGTH = 64

ALLOWED_RESOURCES = {"scripts", "references", "assets"}



SKILL_TEMPLATE = """---

name: {skill_name}

description: "[TODO: What this skill does. Use when <specific trigger scenarios>.]"



metadata:

  starchild:

    emoji:

    skillKey: {skill_name}

    requires:

      env: []

      bins: []



user-invocable: true

---



# {skill_title}



[TODO: 1-2 sentences in direct voice. "You do X" not "This skill does X."

Explain what capability this gives the agent and why it matters.]



## Structuring This Skill



Pick the pattern that fits best, then delete this section:



- **Workflow-based** — Step-by-step process (fetch data -> process -> render -> output)

- **Task-based** — Organized by user request ("analyze X" / "compare Y" / "generate Z")

- **Reference/guidelines** — Rules, decision frameworks, core truths

- **Capabilities-based** — Organized by what the skill can do (tool group A / tool group B)



## [TODO: Main Section]



[TODO: Core instructions the agent needs every time this skill activates.

Focus on knowledge the agent doesn't already have:

- Domain-specific interpretation guides

- Decision trees ("when X, do Y; when Z, do W")

- Gotchas and edge cases

- Key parameters and thresholds]



## Resources



[TODO: Document scripts/, references/, assets/ if used.

Delete this section if no resource directories exist.]

"""



EXAMPLE_SCRIPT = '''#!/usr/bin/env python3

"""

{skill_title} - Helper Script



Usage:

    python scripts/example.py --input <path> [--output <path>]



This script handles [TODO: describe what this automates].

Scripts are for low-freedom operations: fragile API calls, exact rendering,

repetitive boilerplate. The agent executes these via bash, not by reading

them into context.

"""



import argparse

import json

import sys





def main():

    parser = argparse.ArgumentParser(description="{skill_title} helper")

    parser.add_argument("--input", required=True, help="Input file path")

    parser.add_argument("--output", default=None, help="Output file path (default: stdout)")

    args = parser.parse_args()



    # TODO: Replace with actual implementation

    print(f"Processing: {{args.input}}")



    result = {{"status": "ok", "input": args.input}}



    if args.output:

        with open(args.output, "w") as f:

            json.dump(result, f, indent=2)

        print(f"Output written to: {{args.output}}")

    else:

        print(json.dumps(result, indent=2))





if __name__ == "__main__":

    main()

'''



EXAMPLE_REFERENCE = """# {skill_title} — Reference Documentation



This reference is loaded on demand via `read_file` when the agent needs

detailed information beyond what's in the main SKILL.md.



## When to Load This Reference



- Agent needs full API endpoint details

- Agent needs to look up error codes or schema definitions

- Complex multi-step process requires detailed walkthrough



## API Reference



### Authentication



[TODO: How to authenticate — headers, tokens, env vars]



### Endpoints



| Endpoint | Method | Description |

|----------|--------|-------------|

| `/api/example` | GET | [TODO: Description] |

| `/api/example` | POST | [TODO: Description] |



### Error Codes



| Code | Meaning | Recovery |

|------|---------|----------|

| 401 | Invalid API key | Check env var is set |

| 429 | Rate limited | Wait and retry (backoff) |



## Troubleshooting



[TODO: Common issues a