@kurokeita/add-skill 1.11.0 → 1.13.0

package/README.md

@@ -87,6 +87,7 @@ pnpm dev import https://github.com/owner/repo/tree/main/skills/skill-name
 | Platform | Agents Path | Skills Path | Workflows Path |
 | :--- | :--- | :--- | :--- |
 | Antigravity | *Not Supported* | `~/.gemini/antigravity/global_skills` | `~/.gemini/antigravity/global_workflows` |
+| Claude Code | `~/.claude/agents` | `~/.claude/skills` | `~/.claude/skills` |
 | Codex | `~/.codex/skills` | `~/.codex/skills` | `~/.codex/skills` |
 | Gemini CLI | `~/.gemini/agents` | `~/.gemini/skills` | `~/.gemini/commands` |
 | GitHub Copilot | `~/.copilot/agents` | `~/.copilot/skills` | `~/.copilot/prompts` |

package/dist/bin/cli.js

@@ -7,7 +7,7 @@ import pc5 from "picocolors";
 
 // src/commands/add.ts
 import os3 from "node:os";
-import path5 from "node:path";
+import path6 from "node:path";
 import {
   cancel,
   confirm,
@@ -119,6 +119,7 @@ function resolveProjectRoot(moduleDir) {
 var PROJECT_ROOT = resolveProjectRoot(__dirname);
 var PLATFORM_LABELS = {
   antigravity: "Antigravity",
+  "claude-code": "Claude Code",
   codex: "Codex",
   gemini: "Gemini CLI",
   copilot: "GitHub Copilot",
@@ -126,18 +127,21 @@ var PLATFORM_LABELS = {
 };
 var PLATFORM_PATHS_SKILLS = {
   antigravity: path2.join(os2.homedir(), ".gemini/antigravity/global_skills"),
+  "claude-code": path2.join(os2.homedir(), ".claude/skills"),
   codex: path2.join(os2.homedir(), ".codex/skills"),
   copilot: path2.join(os2.homedir(), ".copilot/skills"),
   gemini: path2.join(os2.homedir(), ".gemini/skills"),
   windsurf: path2.join(os2.homedir(), ".codeium/windsurf/skills")
 };
 var PLATFORM_PATHS_AGENTS = {
+  "claude-code": path2.join(os2.homedir(), ".claude/agents"),
   codex: path2.join(os2.homedir(), ".codex/skills"),
   copilot: path2.join(os2.homedir(), ".copilot/agents"),
   gemini: path2.join(os2.homedir(), ".gemini/agents")
 };
 var PLATFORM_PATHS_WORKFLOWS = {
   antigravity: path2.join(os2.homedir(), ".gemini/antigravity/global_workflows"),
+  "claude-code": path2.join(os2.homedir(), ".claude/skills"),
   codex: path2.join(os2.homedir(), ".codex/skills"),
   copilot: path2.join(os2.homedir(), ".copilot/prompts"),
   gemini: path2.join(os2.homedir(), ".gemini/commands"),
@@ -170,11 +174,106 @@ var AntigravityHandler = class {
   }
 };
 
-// src/utils/platforms/codex.ts
+// src/utils/platforms/claude-code.ts
 import path3 from "node:path";
-import fs3 from "fs-extra";
 import yaml from "js-yaml";
 var frontmatterRegex = /^---\n([\s\S]*?)\n---/;
+var CLAUDE_CODE_TOOLS = [
+  "Read",
+  "Edit",
+  "Write",
+  "Bash",
+  "Glob",
+  "Grep",
+  "WebFetch",
+  "WebSearch"
+];
+var ClaudeCodeHandler = class {
+  platform = "claude-code";
+  getTargetFileName(itemName, type) {
+    if (type === "agent") {
+      const name = itemName.replace(/\.md$/, "");
+      return path3.join(name, `${name}.md`);
+    }
+    if (type === "workflow") {
+      const name = itemName.replace(/\.md$/, "");
+      return path3.join(name, "SKILL.md");
+    }
+    return itemName;
+  }
+  transform(content, type, itemName) {
+    if (type === "skill") return content;
+    if (type === "agent") {
+      return this.transformAgent(content, itemName);
+    }
+    if (type === "workflow") {
+      return this.transformWorkflow(content, itemName);
+    }
+    return content;
+  }
+  transformAgent(content, itemName) {
+    const match = content.match(frontmatterRegex);
+    let frontmatter = {
+      name: itemName.replace(/\.md$/, ""),
+      description: "",
+      tools: CLAUDE_CODE_TOOLS
+    };
+    let body = content;
+    if (match) {
+      try {
+        const parsed = yaml.load(match[1]);
+        frontmatter = { ...frontmatter, ...parsed };
+        frontmatter.tools = CLAUDE_CODE_TOOLS;
+        delete frontmatter.target;
+        body = content.replace(frontmatterRegex, "").trim();
+      } catch (_) {
+      }
+    }
+    const yamlStr = yaml.dump(frontmatter);
+    return `---
+${yamlStr}---
+
+${body}`;
+  }
+  transformWorkflow(content, itemName) {
+    const name = itemName.replace(/\.md$/, "");
+    const match = content.match(frontmatterRegex);
+    let description = "";
+    let body = content.trim();
+    if (match) {
+      try {
+        const parsed = yaml.load(match[1]);
+        if (typeof parsed.description === "string" && parsed.description.trim()) {
+          description = parsed.description.trim();
+        }
+        if (typeof parsed.name === "string" && parsed.name.trim()) {
+        }
+      } catch (_) {
+      }
+      body = content.replace(frontmatterRegex, "").trim();
+    }
+    if (!description) {
+      const titleMatch = body.match(/^#\s+(.+)$/m);
+      const title = titleMatch?.[1]?.trim() || name;
+      description = `Workflow: ${title}`;
+    }
+    const frontmatter = yaml.dump({
+      name,
+      description,
+      "user-invocable": true
+    });
+    return `---
+${frontmatter}---
+
+${body}`;
+  }
+};
+
+// src/utils/platforms/codex.ts
+import path4 from "node:path";
+import fs3 from "fs-extra";
+import yaml2 from "js-yaml";
+var frontmatterRegex2 = /^---\n([\s\S]*?)\n---/;
 var CODEX_TYPE_FIELD = "x-ai-agents-type";
 function extractTitle(body) {
   const match = body.match(/^#\s+(.+)$/m);
@@ -193,7 +292,7 @@ function buildDescription(type, itemName, title) {
 function toYamlFrontmatter(name, description, extraFields = {}) {
   const normalizedName = name.replace(/\n+/g, " ").trim();
   const normalizedDescription = description.replace(/\n+/g, " ").trim();
-  return yaml.dump(
+  return yaml2.dump(
     {
       name: normalizedName,
       description: normalizedDescription,
@@ -203,10 +302,10 @@ function toYamlFrontmatter(name, description, extraFields = {}) {
   ).trimEnd();
 }
 function parseCodexType(content) {
-  const match = content.match(frontmatterRegex);
+  const match = content.match(frontmatterRegex2);
   if (!match) return "skill";
   try {
-    const parsed = yaml.load(match[1]);
+    const parsed = yaml2.load(match[1]);
     if (parsed && typeof parsed === "object") {
       const type = parsed[CODEX_TYPE_FIELD];
       if (type === "agent" || type === "workflow" || type === "skill") {
@@ -221,9 +320,9 @@ function parseCodexType(content) {
 async function codexEntryMatchesType(basePath, entry, requestedType) {
   let targetPath = null;
   if (entry.isDirectory()) {
-    targetPath = path3.join(basePath, entry.name, "SKILL.md");
+    targetPath = path4.join(basePath, entry.name, "SKILL.md");
   } else if (entry.isFile() && entry.name.endsWith(".md")) {
-    targetPath = path3.join(basePath, entry.name);
+    targetPath = path4.join(basePath, entry.name);
   }
   if (!targetPath) return false;
   try {
@@ -237,7 +336,7 @@ var CodexHandler = class {
   platform = "codex";
   getTargetFileName(itemName, type) {
     if (type === "agent" || type === "workflow") {
-      return path3.join(path3.parse(itemName).name, "SKILL.md");
+      return path4.join(path4.parse(itemName).name, "SKILL.md");
     }
     return itemName;
   }
@@ -247,11 +346,11 @@ var CodexHandler = class {
     let name = itemName;
     let description = "";
     let body = content.trim();
-    const match = content.match(frontmatterRegex);
+    const match = content.match(frontmatterRegex2);
     if (match) {
-      body = content.replace(frontmatterRegex, "").trim();
+      body = content.replace(frontmatterRegex2, "").trim();
       try {
-        const parsed = yaml.load(match[1]);
+        const parsed = yaml2.load(match[1]);
         if (parsed && typeof parsed === "object") {
           const frontmatter = parsed;
           if (typeof frontmatter.name === "string" && frontmatter.name.trim()) {
@@ -281,7 +380,7 @@ ${body}`;
 };
 
 // src/utils/platforms/copilot.ts
-import yaml2 from "js-yaml";
+import yaml3 from "js-yaml";
 var CopilotHandler = class {
   platform = "copilot";
   getTargetFileName(itemName, type) {
@@ -292,8 +391,8 @@ var CopilotHandler = class {
   }
   transform(content, type, itemName) {
     if (type !== "agent") return content;
-    const frontmatterRegex2 = /^---\n([\s\S]*?)\n---/;
-    const match = content.match(frontmatterRegex2);
+    const frontmatterRegex3 = /^---\n([\s\S]*?)\n---/;
+    const match = content.match(frontmatterRegex3);
     let frontmatter = {
       name: itemName,
       description: "",
@@ -303,7 +402,7 @@ var CopilotHandler = class {
     let body = content;
     if (match) {
       try {
-        const parsed = yaml2.load(match[1]);
+        const parsed = yaml3.load(match[1]);
         frontmatter = { ...frontmatter, ...parsed };
         frontmatter.target = "github-copilot";
         frontmatter.tools = [
@@ -313,11 +412,11 @@ var CopilotHandler = class {
           "grep_search",
           "githubRepo"
         ];
-        body = content.replace(frontmatterRegex2, "").trim();
+        body = content.replace(frontmatterRegex3, "").trim();
       } catch (_) {
       }
     }
-    const yamlStr = yaml2.dump(frontmatter);
+    const yamlStr = yaml3.dump(frontmatter);
     return `---
 ${yamlStr}---
 
@@ -339,7 +438,7 @@ var DefaultHandler = class {
 };
 
 // src/utils/platforms/gemini.ts
-import yaml3 from "js-yaml";
+import yaml4 from "js-yaml";
 
 // src/utils/toml.ts
 function convertToGeminiCommandTOML(markdownContent) {
@@ -382,8 +481,8 @@ var GeminiHandler = class {
       return convertToGeminiCommandTOML(content);
     }
     if (type === "agent") {
-      const frontmatterRegex2 = /^---\n([\s\S]*?)\n---/;
-      const match = content.match(frontmatterRegex2);
+      const frontmatterRegex3 = /^---\n([\s\S]*?)\n---/;
+      const match = content.match(frontmatterRegex3);
       let frontmatter = {
         name: itemName,
         description: "",
@@ -405,7 +504,7 @@ var GeminiHandler = class {
       let body = content;
       if (match) {
         try {
-          const parsed = yaml3.load(match[1]);
+          const parsed = yaml4.load(match[1]);
           frontmatter = { ...frontmatter, ...parsed };
           frontmatter.tools = [
             "list_directory",
@@ -422,11 +521,11 @@ var GeminiHandler = class {
             "activate_skill"
           ];
           delete frontmatter.skills;
-          body = content.replace(frontmatterRegex2, "").trim();
+          body = content.replace(frontmatterRegex3, "").trim();
         } catch (_) {
         }
       }
-      const yamlStr = yaml3.dump(frontmatter);
+      const yamlStr = yaml4.dump(frontmatter);
       return `---
 ${yamlStr}---
 
@@ -437,12 +536,12 @@ ${body}`;
 };
 
 // src/utils/platforms/windsurf.ts
-import path4 from "node:path";
+import path5 from "node:path";
 var WindsurfHandler = class {
   platform = "windsurf";
   getTargetFileName(itemName, type) {
     if (type === "agent") {
-      return path4.join(path4.parse(itemName).name, "AGENTS.md");
+      return path5.join(path5.parse(itemName).name, "AGENTS.md");
     }
     return itemName;
   }
@@ -457,6 +556,7 @@ function registerHandler(handler) {
   handlers.set(handler.platform, handler);
 }
 registerHandler(new AntigravityHandler());
+registerHandler(new ClaudeCodeHandler());
 registerHandler(new CodexHandler());
 registerHandler(new CopilotHandler());
 registerHandler(new GeminiHandler());
@@ -475,7 +575,7 @@ function getPlatformOptions(type) {
   }));
 }
 async function installItem(itemName, overwrite, sourcePath, targetBaseDir) {
-  const targetPath = path5.join(targetBaseDir, itemName);
+  const targetPath = path6.join(targetBaseDir, itemName);
   if (!await fs4.pathExists(sourcePath)) {
     throw new Error(`Item '${itemName}' not found at ${sourcePath}`);
   }
@@ -584,7 +684,7 @@ async function add(type, url, options) {
         const handler = getHandler(platform);
         for (const item of selectedItems) {
           const targetItemName = handler.getTargetFileName(item, normalizedType);
-          const targetPath = path5.join(targetBase, targetItemName);
+          const targetPath = path6.join(targetBase, targetItemName);
           if (await fs4.pathExists(targetPath)) {
             existingItems.push({ item, platform });
           }
@@ -627,14 +727,14 @@ async function add(type, url, options) {
           try {
             let currentSourcePath;
             if (url && tempDir) {
-              const potentialFile = path5.join(tempDir, item);
+              const potentialFile = path6.join(tempDir, item);
               if (await fs4.pathExists(potentialFile) && (await fs4.stat(potentialFile)).isFile()) {
                 currentSourcePath = potentialFile;
               } else {
                 currentSourcePath = tempDir;
               }
             } else {
-              const src = path5.join(TYPE_DIRS[normalizedType], item);
+              const src = path6.join(TYPE_DIRS[normalizedType], item);
               if ((await fs4.stat(src)).isFile()) {
                 currentSourcePath = src;
               } else {
@@ -647,7 +747,7 @@ async function add(type, url, options) {
               normalizedType
             );
             if ((normalizedType === "agent" || normalizedType === "workflow") && currentSourcePath.endsWith(".md")) {
-              const targetPath = path5.join(targetBase, targetItemName);
+              const targetPath = path6.join(targetBase, targetItemName);
               if (!overwrite && await fs4.pathExists(targetPath)) {
                 skippedCount++;
               } else {
@@ -655,9 +755,9 @@ async function add(type, url, options) {
                 content = handler.transform(
                   content,
                   normalizedType,
-                  path5.parse(item).name
+                  path6.parse(item).name
                 );
-                await fs4.ensureDir(path5.dirname(targetPath));
+                await fs4.ensureDir(path6.dirname(targetPath));
                 await fs4.writeFile(targetPath, content);
                 installedCount++;
               }
@@ -715,7 +815,7 @@ async function add(type, url, options) {
 }
 
 // src/commands/import.ts
-import path6 from "node:path";
+import path7 from "node:path";
 import {
   cancel as cancel2,
   confirm as confirm2,
@@ -784,12 +884,12 @@ async function importItem(type, url, options) {
       throw e;
     }
     const shouldFlatten = (normalizedType === "agent" || normalizedType === "workflow") && !isFile;
-    const targetPath = shouldFlatten ? targetBaseDir : path6.join(targetBaseDir, itemName);
+    const targetPath = shouldFlatten ? targetBaseDir : path7.join(targetBaseDir, itemName);
     if (shouldFlatten) {
       const srcFiles = await fs5.readdir(tempDir);
       const conflicts = [];
       for (const file of srcFiles) {
-        if (await fs5.pathExists(path6.join(targetBaseDir, file))) {
+        if (await fs5.pathExists(path7.join(targetBaseDir, file))) {
           conflicts.push(file);
         }
       }
@@ -820,7 +920,7 @@ async function importItem(type, url, options) {
     s.start(`Importing ${itemName} to ${targetBaseDir}...`);
     await fs5.ensureDir(targetBaseDir);
     if (isFile) {
-      await fs5.copy(path6.join(tempDir, itemName), targetPath, {
+      await fs5.copy(path7.join(tempDir, itemName), targetPath, {
         overwrite: true
       });
     } else {
@@ -965,7 +1065,7 @@ async function list(type, options) {
 }
 
 // src/commands/remove.ts
-import path7 from "node:path";
+import path8 from "node:path";
 import {
   confirm as confirm3,
   intro as intro4,
@@ -1079,7 +1179,7 @@ async function remove(type, options) {
       const targetBase = targetPaths[platform];
       if (!targetBase) continue;
       for (const item of selectedItems) {
-        const targetPath = path7.join(targetBase, item);
+        const targetPath = path8.join(targetBase, item);
         if (await fs7.pathExists(targetPath)) {
           sDel.message(`Removing ${pc4.bold(item)} from ${pc4.cyan(platform)}...`);
           try {

package/dist/skills/git-convention/SKILL.md

@@ -0,0 +1,112 @@
+---
+name: git-convention
+description: This skill should be used when the user asks to "create a branch", "commit changes", "create a pull request", "manage branches", or "follow conventional commits". Provides guidelines for version control workflows and commit message formatting.
+version: 1.0.0
+---
+
+# Git Convention
+
+Guide for managing version control workflows, including branching strategies, commit message formatting following Conventional Commits, and pull request management.
+
+## When to Use This Skill
+
+- Creating new feature, bugfix, or maintenance branches
+- Formatting commit messages to follow project standards
+- Preparing and creating pull requests
+- Managing branch lifecycle and cleanup
+- Ensuring consistency across the repository's history
+
+## Branching Strategy
+
+Follow a consistent naming convention for branches to ensure clarity and organization.
+
+### Branch Naming Convention
+
+Use a prefix followed by a descriptive name in kebab-case:
+
+- `feature/` - New features or significant functional additions (e.g., `feature/user-authentication`)
+- `fix/` - Bug fixes and patches (e.g., `fix/login-error`)
+- `refactor/` - Code restructuring without changing behavior (e.g., `refactor/api-client`)
+- `docs/` - Documentation updates (e.g., `docs/update-readme`)
+- `chore/` - Maintenance tasks, dependency updates, or internal tooling (e.g., `chore/update-deps`)
+- `test/` - Adding or modifying tests (e.g., `test/unit-tests-auth`)
+
+### Workflow
+
+1. Start from the main integration branch (e.g., `main` or `develop`).
+2. Ensure the local branch is up-to-date: `git pull origin main`.
+3. Create the new branch: `git checkout -b <prefix>/<description>`.
+
+## Conventional Commits
+
+Format commit messages according to the [Conventional Commits](https://www.conventionalcommits.org/) specification to enable automated changelog generation and easier history browsing.
+
+### Structure
+
+```
+<type>(<scope>): <description>
+
+[optional body]
+
+[optional footer(s)]
+```
+
+### Types
+
+- `feat`: A new feature
+- `fix`: A bug fix
+- `docs`: Documentation only changes
+- `style`: Changes that do not affect the meaning of the code (white-space, formatting, missing semi-colons, etc.)
+- `refactor`: A code change that neither fixes a bug nor adds a feature
+- `perf`: A code change that improves performance
+- `test`: Adding missing tests or correcting existing tests
+- `build`: Changes that affect the build system or external dependencies (example scopes: gulp, broccoli, npm)
+- `ci`: Changes to our CI configuration files and scripts (example scopes: Travis, Circle, BrowserStack, SauceLabs)
+- `chore`: Other changes that don't modify src or test files
+- `revert`: Reverts a previous commit
+
+### Guidelines
+
+- **Description**: Use the imperative, present tense (e.g., "add", not "added" or "adds").
+- **Case**: The description should be in lower-case or sentence-case.
+- **Scope**: Use a scope to provide additional contextual information (e.g., `feat(auth): add login validation`).
+- **Body**: Use the body to explain the "what" and "why" of the change, not the "how".
+- **Footer**: Use the footer to reference issues (e.g., `Closes #123`) or breaking changes.
+
+## Pull Request Management
+
+Create clear and informative pull requests to facilitate effective code review and collaboration.
+
+### PR Creation Process
+
+1. **Push your branch**: `git push origin <branch-name>`.
+2. **Open the PR**: Use the GitHub CLI or web interface.
+3. **Title**: Use the Conventional Commits format for the title (e.g., `feat(ui): add dashboard widgets`).
+4. **Description**: Use a template (if available) to describe:
+    - What changes were made.
+    - Why they were made.
+    - How they were tested.
+    - Any breaking changes or new dependencies.
+
+### Best Practices
+
+- **Keep it focused**: One PR per logical change. Avoid "mega-PRs".
+- **Self-review**: Review your own changes before asking others.
+- **Link issues**: Use keywords like `Fixes #123` or `Closes #123` in the description.
+- **Update regularly**: Rebase or merge from the main branch if the PR becomes stale.
+
+## Additional Resources
+
+### Reference Files
+
+For detailed patterns and advanced git workflows, consult:
+
+- **`references/conventional-commits.md`** - Detailed Conventional Commits specification.
+- **`references/branching-workflows.md`** - Advanced branching and merging strategies.
+
+### Example Files
+
+Working examples in `examples/`:
+
+- **`commit-messages.txt`** - Examples of well-formatted commit messages.
+- **`pr-description-template.md`** - A standard PR description template.

package/dist/skills/git-convention/examples/commit-messages.txt

@@ -0,0 +1,34 @@
+# Example Commit Messages
+
+## Features
+- `feat(ui): add progress bar component`
+- `feat(auth): implement oauth2 login with google`
+- `feat!: change default api version to v2`
+
+## Bug Fixes
+- `fix(parser): handle empty input string gracefully`
+- `fix: resolve race condition in database connection pool`
+- `fix(styles): fix padding issues on mobile devices`
+
+## Documentation
+- `docs: update readme with installation instructions`
+- `docs(api): document the new /user/profile endpoint`
+- `docs: add contributing guide`
+
+## Refactoring
+- `refactor(core): simplify the request handling logic`
+- `refactor: move utility functions to a separate module`
+- `refactor(tests): reduce duplication in integration tests`
+
+## Performance
+- `perf(image): optimize image loading speed using lazy-loading`
+- `perf: add caching layer for frequently accessed data`
+
+## Tests
+- `test(auth): add unit tests for jwt validation`
+- `test: increase coverage for the math module`
+
+## Chore
+- `chore: update dependencies`
+- `chore(deps): bump vite from 4.0 to 5.0`
+- `chore: remove unused log statements`

package/dist/skills/git-convention/examples/pr-description-template.md

@@ -0,0 +1,40 @@
+## Summary
+<!-- Explain the **motivation** for making this change. What existing problem does the pull request solve? -->
+
+## Related Issue
+<!-- Link to the issue this PR addresses (e.g., Fixes #123, Closes #456) -->
+Fixes #
+
+## Type of Change
+<!-- Please delete options that are not relevant -->
+- [ ] Bug fix (non-breaking change which fixes an issue)
+- [ ] New feature (non-breaking change which adds functionality)
+- [ ] Breaking change (fix or feature that would cause existing functionality to not work as expected)
+- [ ] Documentation update
+- [ ] Refactor (code change that neither fixes a bug nor adds a feature)
+
+## How did you test this change?
+<!-- 
+Please describe the tests that you ran to verify your changes. 
+Provide instructions so we can reproduce. 
+Please also list any relevant details for your test configuration.
+-->
+- [ ] Test Case A: ...
+- [ ] Test Case B: ...
+
+### Screenshots (if applicable)
+<!-- Add images to show visual changes -->
+
+## Checklist
+
+- [ ] I have read the [CONTRIBUTING](CONTRIBUTING.md) document.
+- [ ] My code follows the code style of this project.
+- [ ] I have performed a self-review of my own code.
+- [ ] I have commented my code, particularly in hard-to-understand areas.
+- [ ] I have made corresponding changes to the documentation.
+- [ ] My changes generate no new warnings.
+- [ ] I have added tests that prove my fix is effective or that my feature works.
+- [ ] New and existing unit tests pass locally with my changes.
+
+## Special notes for your reviewer
+<!-- Any specific areas you want the reviewer to focus on? -->

package/dist/skills/git-convention/references/branching-workflows.md

@@ -0,0 +1,63 @@
+# Advanced Branching and Merging Strategies
+
+Choosing the right branching strategy is crucial for team collaboration and continuous delivery.
+
+## Gitflow Workflow
+
+Gitflow is a legacy Git workflow that was first published and made popular by Vincent Driessen. It's often used for projects that have a scheduled release cycle.
+
+- `main` branch stores the official release history.
+- `develop` branch serves as an integration branch for features.
+- `feature/*` branches are used for developing new features.
+- `release/*` branches support preparation of a new production release.
+- `hotfix/*` branches are used to quickly patch production releases.
+
+## GitHub Flow
+
+GitHub Flow is a lightweight, branch-based workflow that supports teams and projects where deployments happen regularly.
+
+- Anything in the `main` branch is deployable.
+- To work on something new, create a descriptive branch off of `main`.
+- Commit to that branch locally and regularly push your work to the same named branch on the server.
+- When you need feedback or help, or you think the branch is ready for merging, open a pull request.
+- After someone else has reviewed and signed off on the feature, you can merge it into `main`.
+- Once it is merged and pushed to `main`, you can and should deploy immediately.
+
+## Trunk-Based Development
+
+A version control management strategy where developers merge small, frequent updates to a core “trunk” or main branch.
+
+- High frequency of commits.
+- Small PRs.
+- Continuous Integration.
+- Feature flags are often used to hide work-in-progress.
+
+## Merging vs Rebasing
+
+### Merging
+
+`git merge` is a "non-destructive" operation. The existing branches are not changed in any way. This avoids all of the potential pitfalls of rebasing.
+
+```bash
+git checkout feature/abc
+git merge main
+```
+
+### Rebasing
+
+`git rebase` moves the entire feature branch to begin on the tip of the `main` branch, effectively incorporating all of the new commits in `main`. It re-writes the project history by creating brand new commits for each commit in the original branch.
+
+```bash
+git checkout feature/abc
+git rebase main
+```
+
+**Golden Rule of Rebasing**: Never use it on public branches.
+
+## Conflict Resolution
+
+1. Identify the conflict: `git status` will show unmerged paths.
+2. Open the files and look for `<<<<<<<`, `=======`, `>>>>>>>`.
+3. Decide which changes to keep.
+4. Stage the resolved files: `git add <file>`.
+5. Complete the merge or rebase: `git commit` or `git rebase --continue`.

package/dist/skills/git-convention/references/conventional-commits.md

@@ -0,0 +1,85 @@
+# Conventional Commits Specification
+
+The Conventional Commits specification is a lightweight convention on top of commit messages. It provides an easy set of rules for creating an explicit commit history; which makes it easier to write automated tools on top of.
+
+## The Specification
+
+The commit message should be structured as follows:
+
+```
+<type>[optional scope]: <description>
+
+[optional body]
+
+[optional footer(s)]
+```
+
+### Type
+
+The type is a short string that describes the category of the change. Common types include:
+
+- `feat`: (feature)
+- `fix`: (bug fix)
+- `docs`: (documentation)
+- `style`: (formatting, missing semi-colons, etc; no code change)
+- `refactor`: (refactoring production code)
+- `test`: (adding missing tests, refactoring tests; no production code change)
+- `chore`: (updating grunt tasks etc; no production code change)
+
+### Scope
+
+A scope MAY be provided after a type. A scope MUST consist of a noun describing a section of the codebase surrounded by parenthesis, e.g., `fix(parser):`
+
+### Description
+
+The description contains a succinct description of the change:
+
+- use the imperative, present tense: "change" not "changed" nor "changes"
+- don't capitalize the first letter
+- no dot (.) at the end
+
+### Body
+
+A longer commit body MAY be provided after the short description, providing additional contextual information about the code changes. The body MUST begin one blank line after the description.
+
+### Footer
+
+One or more footers MAY be provided one blank line after the body. Each footer MUST consist of a word token, followed by either a `:<space>` or `<space>#` separator, followed by a string value (this is inspired by the git trailer convention).
+
+### Breaking Changes
+
+A breaking change MUST be indicated by an `!` after the type/scope, or as a footer entry starting with `BREAKING CHANGE:`.
+
+## Examples
+
+### Commit message with description and breaking change footer
+
+```
+feat: allow provided config object to extend other configs
+
+BREAKING CHANGE: `extends` key in config file is now used for extending other config files
+```
+
+### Commit message with ! to draw attention to breaking change
+
+```
+feat!: send an email to the customer when a product is shipped
+```
+
+### Commit message with scope and ! to draw attention to breaking change
+
+```
+chore(api)!: drop support for Node 6
+```
+
+### Commit message with multi-paragraph body and multiple footers
+
+```
+fix: prevent racing of requests
+
+Introduce a request id and a reference to latest request. All
+rest responses are checked against the current id before update.
+
+Reviewers: adrian, jdoe
+Fixes #123
+```

package/dist/skills/git-convention/references/pr-best-practices.md

@@ -0,0 +1,66 @@
+# Pull Request Description Best Practices
+
+A well-crafted pull request (PR) description is essential for effective code review, maintaining project history, and ensuring that changes meet quality standards.
+
+## Core Components
+
+The most effective PR templates across major open-source repositories (like React, VS Code, and Kubernetes) share these core components:
+
+### 1. Summary & Motivation
+
+Explain **what** you changed and **why** you changed it.
+
+- What problem does this PR solve?
+- What is the context for this change?
+- Are there any architectural decisions or trade-offs made?
+
+### 2. Related Issues
+
+Always link to the issue(s) being addressed. Use keywords that GitHub recognizes to automatically close issues when the PR is merged:
+
+- `Fixes #123`
+
+- `Closes #123`
+
+- `Resolves #123`
+
+### 3. Type of Change
+
+Categorize the PR to help maintainers quickly understand its impact:
+
+- **Bug Fix**: Non-breaking change that fixes an issue.
+
+- **New Feature**: Non-breaking change that adds functionality.
+
+- **Breaking Change**: Fix or feature that would cause existing functionality to change.
+- **Documentation**: Changes to documentation only.
+- **Refactor**: Code change that neither fixes a bug nor adds a feature.
+
+### 4. Test Plan (Verification)
+
+Describe how you verified your changes. This is the most critical section for reviewers.
+
+- **Automated Tests**: Mention new or existing tests that cover the changes.
+- **Manual Testing**: List the steps taken to manually verify the behavior.
+- **Screenshots/Gifs**: Provide visual evidence for UI/UX changes.
+
+### 5. Checklist
+
+A set of mandatory steps the contributor must confirm:
+
+- [ ] My code follows the project's style guidelines.
+- [ ] I have performed a self-review of my code.
+- [ ] I have added tests that cover my changes.
+- [ ] All new and existing tests passed.
+- [ ] I have updated the documentation accordingly.
+
+### 6. Special Notes for Reviewers
+
+Use this section to highlight specific areas where you need feedback or to explain complex logic that might be hard to follow.
+
+## Best Practices
+
+- **Keep it focused**: One logical change per PR. Small PRs are easier to review and less likely to introduce bugs.
+- **Write for the future**: Your PR description will be part of the repository's history. Write it so that someone reading it a year from now can understand the context.
+- **Be concise but thorough**: Avoid "fluff," but don't leave out critical information.
+- **Update the description**: If the PR evolves during the review process, update the description to reflect the final state of the changes.

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@kurokeita/add-skill",
-	"version": "1.11.0",
+	"version": "1.13.0",
 	"description": "CLI to install AI agent skills to various platforms",
 	"type": "module",
 	"bin": {