create-agent-skills 1.0.0 → 1.1.1

package/README.md

@@ -41,6 +41,12 @@ npx create-agent-skills
 | `code-review` | Reviews code for bugs, style, and security issues |
 | `create-agent-skill` | Helps create new skills following guidelines |
 | `documentation` | Creates clear READMEs, API docs, and comments |
+| `git-commit` | Writes conventional commit messages |
+| `git-pr` | Creates well-structured pull requests |
+| `git-review` | Reviews PRs for code quality and best practices |
+| `maestro-testing` | Write E2E tests for mobile/web apps using Maestro |
+| `tailwindcss-v4` | Tailwind CSS v4 setup and migration guide |
+| `tauri-v2` | Build desktop apps with Tauri v2 + React |
 | `testing` | Helps write unit, integration, and E2E tests |
 
 ## Creating New Skills

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-agent-skills",
-  "version": "1.0.0",
+  "version": "1.1.1",
   "description": "CLI tool to install Agent Skills for AI coding assistants",
   "main": "lib/index.js",
   "bin": {

package/skills/create-agent-skill/SKILL.md

@@ -80,25 +80,65 @@ mkdir -p .agent/skills/<skill-name>/examples
 mkdir -p .agent/skills/<skill-name>/resources
 ```
 
-## When to Use External Files
+## Managing Long Skills
+
+> [!WARNING]
+> **SKILL.md MUST NOT exceed 500 lines.** If your skill is getting too long, you MUST split content into external files.
+
+### File Length Rules
+
+| SKILL.md Length | Action Required |
+|-----------------|-----------------|
+| < 300 lines | ✅ OK - Keep everything in SKILL.md |
+| 300-500 lines | ⚠️ Consider splitting large examples |
+| > 500 lines | ❌ MUST split into external files |
+
+### How to Split Long Skills
+
+1. **Move examples to `examples/` folder**
+   ```bash
+   mkdir -p .agent/skills/<skill-name>/examples
+   ```
+   
+2. **Move reference docs to `resources/` folder**
+   ```bash
+   mkdir -p .agent/skills/<skill-name>/resources
+   ```
+
+3. **Keep SKILL.md focused on:**
+   - Overview and when to use
+   - Quick start / essential commands
+   - Links to detailed examples
+   - Best practices summary
+
+4. **Link external files in SKILL.md:**
+   ```markdown
+   ## Examples & Resources
+   
+   ### Examples
+   - [Basic Usage](examples/basic-usage.md) - Getting started example
+   - [Advanced Patterns](examples/advanced-patterns.md) - Complex use cases
+   
+   ### Resources
+   - [Commands Reference](resources/commands-reference.md) - Full command list
+   - [Configuration Guide](resources/configuration.md) - All config options
+   ```
+
+### What Goes Where
+
+| Content Type | Location | Max Size |
+|--------------|----------|----------|
+| Overview, when to use | `SKILL.md` | - |
+| Quick examples (< 50 lines) | `SKILL.md` | 50 lines each |
+| Long examples (> 50 lines) | `examples/*.md` | No limit |
+| Full API/command reference | `resources/*.md` | No limit |
+| Helper scripts | `scripts/*.js` | No limit |
+| Templates, configs | `resources/*` | No limit |
+
+### Links Requirement
 
-Split content into folders if SKILL.md exceeds ~500 lines:
-
-| Folder | Use For |
-|--------|---------|
-| `examples/` | Complete, runnable code examples |
-| `scripts/` | Helper scripts the agent should run |
-| `resources/` | Templates, config files, assets |
-
-Link to external files using relative paths:
-
-```markdown
-## Examples
-
-See complete examples:
-- [Basic Usage](./examples/basic-usage.js)
-- [Advanced Patterns](./examples/advanced-patterns.js)
-```
+> [!IMPORTANT]
+> Every file in `examples/`, `scripts/`, and `resources/` folders **MUST be linked** in SKILL.md. Unlinked files will not be discovered by the agent.
 
 ## SKILL.md Template