Commit `2d0164b83364`

Vincent Demeester <vincent@sbr.pm>

2025-12-04 23:02:01

docs(skills): add tool development guidelines to Createskill

- Document preference for shell scripts over TypeScript for portability - Provide nix-shell and uv shebang examples for dependency management - Enable self-contained, portable skill tools without global installs - Establish consistent tool development patterns across skills Signed-off-by: Vincent Demeester <vincent@sbr.pm>

main

1 parent 4c85983

Changed files (1)

dots

.config

claude

skills

Createskill

SKILL.md

@@ -13,7 +13,7 @@ Systematic skill creation framework for building consistent, well-structured Cla
 - User wants to create a new skill
 - User asks to validate, update, or fix an existing skill
 - User mentions skill structure, compliance, or canonicalization
-- User is working in `/home/vincent/.claude/skills/` directory
+- User is working in `/home/vincent/.config/claude/skills/` directory
 - User asks about skill creation best practices or framework
 
 ## TitleCase Naming Convention
@@ -25,7 +25,7 @@ Systematic skill creation framework for building consistent, well-structured Cla
 | Skill directory | TitleCase | `Golang`, `Homelab`, `Createskill` |
 | Workflow files | TitleCase.md | `Create.md`, `UpdateInfo.md` |
 | Reference docs | TitleCase.md | `Guide.md`, `Reference.md` |
-| Tool files | TitleCase.ts | `ManageTool.ts` |
+| Tool files | TitleCase.sh | `ManageTool.sh` |
 
 **Wrong (NEVER use):**
 - `createskill`, `create-skill`, `CREATE_SKILL`
@@ -122,6 +122,28 @@ User: "Validate the golang skill"
 - Keep workflows focused on single tasks
 - Use TitleCase.md naming
 
+### Tools
+- **Prefer shell scripts** for tools (simplicity, portability)
+- **Use Python** only when complexity requires it (complex parsing, data structures)
+- **Avoid TypeScript** - not preferred for skill tools
+- Name tools with TitleCase.sh or TitleCase.py
+- Keep tools focused and single-purpose
+
+**Dependency Management:**
+- **For shell scripts with dependencies:** Use `nix-shell` shebang for maximum portability
+  ```bash
+  #!/usr/bin/env nix-shell
+  #! nix-shell -i bash -p jq curl
+  ```
+- **For Python scripts with dependencies:** Use `uv` shebang for isolated environments
+  ```python
+  #!/usr/bin/env -S uv run --quiet --script
+  # /// script
+  # dependencies = ["requests", "click"]
+  # ///
+  ```
+- This makes scripts portable without requiring global installation of dependencies
+
 ### Examples
 - Provide at least one concrete example
 - Show the trigger phrase and expected behavior

Commit 2d0164b83364

Commit `2d0164b83364`