Skip to content
Back to search

agent-skills-platform

MarketplaceWorks with Claude CodeGitHub

Turn any workflow into reusable AI agent software that installs on 17 platforms.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/francyjglisboa--agent-skills-platform/badge.svg)](/listings/francyjglisboa--agent-skills-platform)

HTML

<a href="/listings/francyjglisboa--agent-skills-platform"><img src="/api/listings/francyjglisboa--agent-skills-platform/badge.svg" alt="findsafeskills safety rating" /></a>

Install

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 17 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. {
  2. "$schema": "https://anthropic.com/claude-code/marketplace.schema.json",
  3. "name": "agent-skills-platform",
  4. "description": "Turn any workflow into reusable AI agent software that installs on 17 platforms.",
  5. "owner": {
  6. "name": "Francy Lisboa Charuto",
  7. "url": "https://github.com/FrancyJGLisboa"
  8. },
  9. "plugins": [
  10. {
  11. "name": "agent-skills-platform",
  12. "source": "./",
  13. "description": "Skill factory: describe a workflow in plain English and receive a validated, security-scanned cross-platform agent skill with evals and an installer.",
  14. "category": "productivity"
  15. }
  16. ]
  17. }
README.md · README · 187 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # Agent Skills Platform
  2. **Turn a real workflow into a tested, installable agent skill—then publish it safely to your team.**
  3. ![Agent Skills Platform: question to tested skill to governed marketplace](docs/assets/agent-skills-platform-social-preview.png)
  4. [![CI](https://github.com/FrancyJGLisboa/agent-skills-platform/actions/workflows/ci.yml/badge.svg)](https://github.com/FrancyJGLisboa/agent-skills-platform/actions/workflows/ci.yml)
  5. [![Agent Skills Open Standard](https://img.shields.io/badge/Agent%20Skills-Open%20Standard-blue)](https://github.com/agentskills/agentskills/blob/main/docs/specification.mdx)
  6. [![Platforms](https://img.shields.io/badge/installs%20on-17%20platforms-7c3aed)](docs/INSTALL.md)
  7. [![Version](https://img.shields.io/badge/version-6.1.0-brightgreen)]()
  8. [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)]()
  9. [Website](https://francyjglisboa.github.io/agent-skills-platform/) ·
  10. [Installation](docs/INSTALL.md) ·
  11. [Worker runbook](docs/WORKER_RUNBOOK.md) ·
  12. [Team marketplace](docs/TEAM_MARKETPLACE.md) ·
  13. [Product scope](docs/PRODUCT_SCOPE.md)
  14. Agent Skills Platform turns the way people already work into tested, installable agent
  15. skills. Give it a prompt plus the evidence behind the work—spreadsheets, reports,
  16. emails, screenshots, transcripts, links, or scripts—and it builds a reusable workflow
  17. that a person can inspect, an organization can review, and a team can safely reuse.
  18. ```text
  19. /agent-skills-platform
  20. Turn my monthly revenue-variance review into a reusable internal skill.
  21. I attached past reports and the source spreadsheets. The decision is whether to
  22. escalate a material variance. It must not modify source data.
  23. ```
  24. The result is not just a prompt: it is an installable skill package with instructions,
  25. functional scripts when needed, evals, security checks, a representative-run record,
  26. and a correction path for real-world learning.
  27. After release, a skill can retain maintenance evidence without turning every log
  28. into runtime prompt context: classified run evidence is captured in `raw/`, recurring
  29. findings become evidence-linked draft patterns in `wiki/`, and only a separately
  30. validated change may update the executable skill. This is a governed maintenance
  31. record, not autonomous self-modification.
  32. ## Create your first skill
  33. Choose the path that matches what you need today.
  34. **First question:** is this skill just for you, or will teammates install or reuse the
  35. skill itself?
  36. - **Just for you** — create, verify, and install it privately. No marketplace setup.
  37. - **My team** — create or select a governed GitHub/GitLab marketplace first, so the
  38. skill inherits real ownership and approval rules.
  39. Teammates receiving a report or queue does not require a marketplace. Use the team
  40. path only when teammates will install or reuse the skill.
  41. ### I have a workflow — no code required
  42. Open the AI agent you already use, attach examples of the work, and paste this:
  43. ```text
  44. /agent-skills-platform
  45. Turn my monthly revenue-variance review into a reusable internal skill.
  46. I attached past reports and the source spreadsheets. The decision is whether to
  47. escalate a material variance. It must not modify source data.
  48. ```
  49. The creator asks for the business decisions only you can authorize, builds and tests
  50. the skill, and shows a representative result. When it is correct, say: **“Publish
  51. this to the Finance marketplace.”**
  52. When the workflow uses an API, database, MCP, codebase, or structured file, Semantic
  53. Recon runs automatically before implementation and creates a pinned data contract.
  54. Use `./install.sh --without-semantic-recon` only for a deliberately local,
  55. source-free installation.
  56. Do not use Git, edit registry files, or run marketplace commands. If the creator is
  57. not installed in your agent, send this section to your marketplace operator.
  58. ### My teammates just need to install skills
  59. Give them the [desktop app](docs/DESKTOP_APP.md): download, paste the team-library
  60. link, click Install. Skills land in GitHub Copilot (or the tool they pick) with no
  61. terminal, Python, or Git involved. The same page shows admins how to create a
  62. library in four commands.
  63. ### I run the marketplace
  64. Use the [governed team marketplace guide](docs/TEAM_MARKETPLACE.md) to admit,
  65. approve, release, distribute, update, quarantine, and roll back tested skills.
  66. ### I am evaluating the platform
  67. Read the [product scope](docs/PRODUCT_SCOPE.md),
  68. [organizational acceptance protocol](docs/ORGANIZATIONAL_ACCEPTANCE.md), and
  69. [technical implementation guide](docs/TECHNICAL_OVERVIEW.md).
  70. ## Why teams use it
  71. - **Preserve expert judgment.** A skill captures the question, evidence, decision,
  72. and success measure behind recurring work.
  73. - **Trust what is shared.** Skills carry validation, security checks, evals, and a
  74. representative run before they are published; for Claude Code and Codex the
  75. marketplace can also certify a skill from real agent runs (`reliability`).
  76. - **Learn without runtime bloat.** Maintenance keeps evidence, draft patterns, and
  77. rejected changes separate from the concise instructions an agent executes.
  78. - **Govern team use.** The marketplace provides ownership, approvals, versioned
  79. releases, discovery, rollback, quarantine, and compatibility evidence.
  80. ## How work moves through the organization
  81. ```text
  82. SME supplies examples and approves the result
  83. ↓
  84. Creator builds and verifies a skill
  85. ↓
  86. Marketplace operator governs and publishes it
  87. ↓
  88. Colleagues install an approved version and use it
  89. ```
  90. The SME owns business meaning. The marketplace operator owns distribution and policy.
  91. See [roles and handoffs](docs/TEAM_MARKETPLACE.md#roles-and-handoffs).
  92. ## See a verified result
  93. The repository includes a live, read-only weather briefing example with a source-linked
  94. result and verification evidence. Start with the
  95. [verification record](docs/verification/2026-08-27-live-weather-briefing.md), then
  96. inspect the [skill package](references/examples/live-weather-briefing-skill).
  97. ## Read more when needed
  98. | Need | Read |
  99. |---|---|
  100. | Install on a supported AI tool | [Installation](docs/INSTALL.md) |
  101. | Let non-technical teammates browse and install skills | [Desktop app](docs/DESKTOP_APP.md) |
  102. | Create, correct, and hand off a first skill | [Worker runbook](docs/WORKER_RUNBOOK.md) |
  103. | Run a governed internal marketplace | [Team marketplace](docs/TEAM_MARKETPLACE.md) |
  104. | Test a skill inside a real agent and certify it per runtime | [Caliper pilot](docs/CALIPER.md) |
  105. | Understand scope and product boundaries | [Product scope](docs/PRODUCT_SCOPE.md) |
  106. | Review architecture, validation, and technical controls | [Technical overview](docs/TECHNICAL_OVERVIEW.md) |
  107. | Contribute | [Contributing](CONTRIBUTING.md) |
  108. ## What happens behind the scenes
  109. An Agent Skill is a reusable workflow package that guides an agent from a
  110. recognized situation to a verified outcome. It can use retrieved knowledge, MCP
  111. tools, APIs, deterministic scripts, and agent judgment, but it is not itself a
  112. RAG system, MCP server, or agent runtime.
  113. RAG supplies knowledge. MCP supplies capabilities. The harness supplies
  114. execution. A skill organizes them into a governed path toward a verified
  115. outcome.
  116. Reason where interpretation is necessary. Execute and verify with deterministic
  117. controls where reproducibility matters. External models, APIs, and changing data
  118. may vary rather than promising identical outputs.
  119. Humans establish meaning. The factory does not expect you to know the correct
  120. prompt or semantic contract; it asks one bounded question at a time. The flow is:
  121. - Messy problem
  122. - Agent inspects evidence
  123. - Proposed / conflicting meanings
  124. - Human authority decision
  125. - Interview READY
  126. - Build, prove, publish
  127. Every skill is checked as one connected system. The skill graph links its
  128. instructions, scripts, evaluations, and expected outputs. Two structural
  129. requirements confirm that every expected result is tested and every predictable
  130. multi-step workflow has one reliable entry point. Four checks—specification,
  131. pipeline, security, and evaluation schema—run in parallel. Finally, a
  132. representative run proves that the skill produces a useful result. The graph also
  133. enforces `every_expected_is_reachable` and `deterministic_multistep_has_orchestrator`.
  134. After intake, `team_marketplace.py reliability` can run the skill inside each installed
  135. agent runtime k times and certify only what an agent actually discovered and followed
  136. ([Caliper](docs/CALIPER.md)).
  137. See [CONTRIBUTING.md](CONTRIBUTING.md) and [CODE_OF_CONDUCT.md](CODE_OF_CONDUCT.md).
  138. Contributions require the [contributor assignment](CONTRIBUTOR_ASSIGNMENT.md).
  139. ## License
  140. MIT. See [LICENSE](LICENSE). Copyright © 2026 Francy J G Lisboa, also known as
  141. Charuto. See [ownership](COPYRIGHT.md).
scripts/bootstrap.bat · Bundled script · 29 lines · 1 finding marked
  1. @echo off
  2. REM bootstrap.bat — One-liner bootstrap for agent-skills-platform (Windows CMD)
  3. REM
  4. REM Usage (paste into Command Prompt):
  5. REM curl -fsSL https://raw.githubusercontent.com/FrancyJGLisboa/agent-skills-platform/main/scripts/bootstrap.bat -o %TEMP%\bootstrap.bat && %TEMP%\bootstrap.bat
  6. REM
  7. REM This is a thin wrapper that launches the PowerShell bootstrap script.
  8. echo.
  9. echo Agent Skills Platform - Bootstrap Installer
  10. echo.
  11. REM Check if PowerShell is available
  12. where powershell >nul 2>&1
  13. if %ERRORLEVEL% neq 0 (
  14. echo [ERROR] PowerShell is not available on this system.
  15. echo Please install PowerShell or use the PowerShell one-liner instead.
  16. echo https://learn.microsoft.com/en-us/powershell/scripting/install/installing-powershell-on-windows
  17. exit /b 1
  18. )
  19. REM Run the PowerShell bootstrap directly from GitHub
  20. powershell -ExecutionPolicy Bypass -Command "irm https://raw.githubusercontent.com/FrancyJGLisboa/agent-skills-platform/main/scripts/bootstrap.ps1 | iex"
  21. if %ERRORLEVEL% neq 0 (
  22. echo.
  23. echo [ERROR] Installation failed. See errors above.
  24. exit /b 1
  25. )
scripts/bootstrap.ps1 · Bundled script · 239 lines · 2 findings marked
  1. # bootstrap.ps1 — One-liner bootstrap for agent-skills-platform (Windows)
  2. #
  3. # Usage (PowerShell):
  4. # irm https://raw.githubusercontent.com/FrancyJGLisboa/agent-skills-platform/main/scripts/bootstrap.ps1 | iex
    • Note: Runs a downloaded PowerShell script (iex / Invoke-Expression)
    • Line 4 on GitHub
  5. #
  6. # Usage (Command Prompt):
  7. # powershell -ExecutionPolicy Bypass -Command "irm https://raw.githubusercontent.com/FrancyJGLisboa/agent-skills-platform/main/scripts/bootstrap.ps1 | iex"
    • Note: Runs a downloaded PowerShell script (iex / Invoke-Expression)
    • Line 7 on GitHub
  8. #
  9. # Clones agent-skills-platform to ~/.agents/skills/ and creates junctions/symlinks
  10. # to all detected global platforms. Works on PowerShell 5.1+ and PowerShell Core 7+.
  11. $ErrorActionPreference = "Stop"
  12. # ---------------------------------------------------------------------------
  13. # Constants
  14. # ---------------------------------------------------------------------------
  15. $RepoUrl = "https://github.com/FrancyJGLisboa/agent-skills-platform.git"
  16. $SkillName = "agent-skills-platform"
  17. $HomeDir = $env:USERPROFILE
  18. $CanonicalDir = Join-Path $HomeDir ".agents" "skills" $SkillName
  19. # ---------------------------------------------------------------------------
  20. # Logging helpers
  21. # ---------------------------------------------------------------------------
  22. function Write-Info { param($msg) Write-Host "[INFO] $msg" -ForegroundColor Blue }
  23. function Write-Ok { param($msg) Write-Host "[OK] $msg" -ForegroundColor Green }
  24. function Write-Warn { param($msg) Write-Host "[WARN] $msg" -ForegroundColor Yellow }
  25. function Write-Err { param($msg) Write-Host "[ERROR] $msg" -ForegroundColor Red }
  26. # ---------------------------------------------------------------------------
  27. # Check for git
  28. # ---------------------------------------------------------------------------
  29. function Test-GitInstalled {
  30. try {
  31. $null = Get-Command git -ErrorAction Stop
  32. return $true
  33. } catch {
  34. return $false
  35. }
  36. }
  37. # ---------------------------------------------------------------------------
  38. # Create a directory junction (works without admin on Windows)
  39. # Falls back to copying if junctions fail.
  40. # ---------------------------------------------------------------------------
  41. function New-SkillLink {
  42. param(
  43. [string]$Target,
  44. [string]$LinkPath
  45. )
  46. if ($Target -eq $LinkPath) { return }
  47. $parentDir = Split-Path $LinkPath -Parent
  48. if (-not (Test-Path $parentDir)) {
  49. New-Item -ItemType Directory -Path $parentDir -Force | Out-Null
  50. }
  51. # Remove existing item
  52. if (Test-Path $LinkPath) {
  53. Remove-Item $LinkPath -Recurse -Force
  54. }
  55. # Try directory junction first (no admin required)
  56. try {
  57. cmd /c mklink /J "`"$LinkPath`"" "`"$Target`"" 2>$null | Out-Null
  58. if (Test-Path $LinkPath) {
  59. return
  60. }
  61. } catch {}
  62. # Try symbolic link (may need admin)
  63. try {
  64. New-Item -ItemType SymbolicLink -Path $LinkPath -Target $Target -Force | Out-Null
  65. if (Test-Path $LinkPath) {
  66. return
  67. }
  68. } catch {}
  69. # Fallback: copy
  70. Write-Warn "Junction/symlink failed for $LinkPath - falling back to copy"
  71. Copy-Item -Path $Target -Destination $LinkPath -Recurse -Force
  72. }
  73. # ---------------------------------------------------------------------------
  74. # Detect globally-installed platforms (user-level only)
  75. # ---------------------------------------------------------------------------
  76. function Get-DetectedPlatforms {
  77. $platforms = @()
  78. $checks = @(
  79. @{ Dir = ".claude"; Name = "claude-code"; Display = "Claude Code" },
  80. @{ Dir = ".copilot"; Name = "github-copilot"; Display = "GitHub Copilot" },
  81. @{ Dir = ".gemini"; Name = "gemini"; Display = "Gemini CLI" },
  82. @{ Dir = ".kiro"; Name = "kiro"; Display = "Kiro" },
  83. @{ Dir = ".cline"; Name = "cline"; Display = "Cline" },
  84. @{ Dir = ".roo"; Name = "roo-code"; Display = "Roo Code" },
  85. @{ Dir = ".kilocode"; Name = "kilo-code"; Display = "Kilo Code" },
  86. @{ Dir = ".factory"; Name = "factory"; Display = "Factory Droid" },
  87. @{ Dir = ".cursor"; Name = "cursor"; Display = "Cursor" }
  88. )
  89. foreach ($check in $checks) {
  90. $testPath = Join-Path $HomeDir $check.Dir
  91. if (Test-Path $testPath) {
  92. $platforms += $check
  93. }
  94. }
  95. # Config-based paths (Goose, OpenCode)
  96. $configDir = Join-Path $HomeDir ".config"
  97. if (Test-Path (Join-Path $configDir "goose")) {
  98. $platforms += @{ Dir = ".config/goose"; Name = "goose"; Display = "Goose" }
  99. }
  100. if (Test-Path (Join-Path $configDir "opencode")) {
  101. $platforms += @{ Dir = ".config/opencode"; Name = "opencode"; Display = "OpenCode" }
  102. }
  103. # Also check Windows-native AppData paths
  104. $appData = $env:APPDATA
  105. if ($appData) {
  106. if (Test-Path (Join-Path $appData "Claude")) {
  107. # Claude Desktop on Windows
  108. $platforms += @{ Dir = "AppData/Claude"; Name = "claude-desktop"; Display = "Claude Desktop" }
  109. }
  110. }
  111. return $platforms
  112. }
  113. # ---------------------------------------------------------------------------
  114. # Resolve install path for a platform
  115. # ---------------------------------------------------------------------------
  116. function Get-PlatformPath {
  117. param([string]$PlatformName)
  118. switch ($PlatformName) {
  119. "claude-code" { return Join-Path $HomeDir ".claude" "skills" $SkillName }
  120. "github-copilot" { return Join-Path $HomeDir ".copilot" "skills" $SkillName }
  121. "gemini" { return Join-Path $HomeDir ".gemini" "skills" $SkillName }
  122. "kiro" { return Join-Path $HomeDir ".kiro" "skills" $SkillName }
  123. "cline" { return Join-Path $HomeDir ".cline" "skills" $SkillName }
  124. "roo-code" { return Join-Path $HomeDir ".roo" "skills" $SkillName }
  125. "kilo-code" { return Join-Path $HomeDir ".kilocode" "skills" $SkillName }
  126. "factory" { return Join-Path $HomeDir ".factory" "skills" $SkillName }
  127. "cursor" { return Join-Path $HomeDir ".cursor" "rules" $SkillName }
  128. "goose" { return Join-Path $HomeDir ".config" "goose" "skills" $SkillName }
  129. "opencode" { return Join-Path $HomeDir ".config" "opencode" "skills" $SkillName }
  130. default { return Join-Path $HomeDir ".agents" "skills" $SkillName }
  131. }
  132. }
  133. # ---------------------------------------------------------------------------
  134. # Main
  135. # ---------------------------------------------------------------------------
  136. function Main {
  137. Write-Host ""
  138. Write-Host "Agent Skills Platform - Bootstrap Installer (Windows)" -ForegroundColor White -NoNewline
  139. Write-Host ""
  140. Write-Host ""
  141. # Check for git
  142. if (-not (Test-GitInstalled)) {
  143. Write-Err "git is not installed."
  144. Write-Host ""
  145. Write-Host "Install git from: https://git-scm.com/downloads/win" -ForegroundColor Yellow
  146. Write-Host ""
  147. Write-Host "Or with winget: winget install Git.Git" -ForegroundColor Yellow
  148. Write-Host "Or with choco: choco install git" -ForegroundColor Yellow
  149. Write-Host ""
  150. exit 1
  151. }
  152. # Clone or update the canonical location
  153. if (Test-Path (Join-Path $CanonicalDir ".git")) {
  154. Write-Info "Updating existing install at $CanonicalDir"
  155. Push-Location $CanonicalDir
  156. try { git pull --ff-only 2>$null } catch {}
  157. Pop-Location
  158. } else {
  159. Write-Info "Cloning $SkillName to $CanonicalDir"
  160. $parentDir = Split-Path $CanonicalDir -Parent
  161. if (-not (Test-Path $parentDir)) {
  162. New-Item -ItemType Directory -Path $parentDir -Force | Out-Null
  163. }
  164. if (Test-Path $CanonicalDir) {
  165. Remove-Item $CanonicalDir -Recurse -Force
  166. }
  167. git clone $RepoUrl $CanonicalDir
  168. if ($LASTEXITCODE -ne 0) {
  169. Write-Err "git clone failed. Check your internet connection and try again."
  170. exit 1
  171. }
  172. }
  173. Write-Ok "Installed at $CanonicalDir"
  174. # Detect global platforms and create junctions
  175. $platforms = Get-DetectedPlatforms
  176. $count = 0
  177. foreach ($platform in $platforms) {
  178. $dest = Get-PlatformPath $platform.Name
  179. New-SkillLink -Target $CanonicalDir -LinkPath $dest
  180. Write-Ok "Linked for $($platform.Display) -> $dest"
  181. $count++
  182. }
  183. # ---------------------------------------------------------------------------
  184. # Summary
  185. # ---------------------------------------------------------------------------
  186. Write-Host ""
  187. Write-Host "Done!" -ForegroundColor Green
  188. Write-Host ""
  189. Write-Host " Canonical location: $CanonicalDir"
  190. if ($count -gt 0) {
  191. $names = ($platforms | ForEach-Object { $_.Display }) -join ", "
  192. Write-Host " Linked to $count platform(s): $names"
  193. }
  194. Write-Host ""
  195. Write-Host "How to use:" -ForegroundColor White
  196. Write-Host " Open your AI agent and type:"
  197. Write-Host " /agent-skills-platform <describe your workflow>"
  198. Write-Host ""
  199. Write-Host " To update later:"
  200. Write-Host " cd $CanonicalDir; git pull"
  201. Write-Host ""
  202. if ($count -eq 0) {
  203. Write-Warn "No global platforms detected. The skill is installed at the universal path."
  204. Write-Host " Tools like Codex CLI, Gemini CLI, Kiro, and others"
  205. Write-Host " read from ~/.agents/skills/ automatically."
  206. Write-Host ""
  207. }
  208. }
  209. Main
scripts/bootstrap.sh · Bundled script · 217 lines · 1 finding marked
  1. #!/bin/sh
  2. # bootstrap.sh — One-liner bootstrap for agent-skills-platform
  3. #
  4. # Usage:
  5. # curl -fsSL https://raw.githubusercontent.com/FrancyJGLisboa/agent-skills-platform/main/scripts/bootstrap.sh | sh
    • Note: Pipes a downloaded script directly into a shell (curl | sh / wget | bash)
    • Line 5 on GitHub
  6. #
  7. # Clones agent-skills-platform to ~/.agents/skills/ and symlinks to all detected
  8. # global platforms. POSIX-compatible (works in bash, dash, zsh, ash).
  9. set -eu
  10. # ---------------------------------------------------------------------------
  11. # Constants
  12. # ---------------------------------------------------------------------------
  13. REPO_URL="https://github.com/FrancyJGLisboa/agent-skills-platform.git"
  14. SKILL_NAME="agent-skills-platform"
  15. CANONICAL_DIR="$HOME/.agents/skills/$SKILL_NAME"
  16. # ---------------------------------------------------------------------------
  17. # Colors (disabled when stdout is not a terminal)
  18. # ---------------------------------------------------------------------------
  19. if [ -t 1 ]; then
  20. GREEN='\033[0;32m'
  21. YELLOW='\033[1;33m'
  22. BLUE='\033[0;34m'
  23. BOLD='\033[1m'
  24. NC='\033[0m'
  25. else
  26. GREEN='' YELLOW='' BLUE='' BOLD='' NC=''
  27. fi
  28. info() { printf "${BLUE}[INFO]${NC} %s\n" "$1"; }
  29. success() { printf "${GREEN}[OK]${NC} %s\n" "$1"; }
  30. warn() { printf "${YELLOW}[WARN]${NC} %s\n" "$1"; }
  31. # ---------------------------------------------------------------------------
  32. # Detect globally-installed platforms (user-level only, skip project-level)
  33. # ---------------------------------------------------------------------------
  34. detect_global_platforms() {
  35. platforms=""
  36. # Claude Code
  37. if [ -d "$HOME/.claude" ]; then
  38. platforms="$platforms claude-code"
  39. fi
  40. # GitHub Copilot
  41. if [ -d "$HOME/.copilot" ]; then
  42. platforms="$platforms github-copilot"
  43. fi
  44. # Gemini CLI
  45. if [ -d "$HOME/.gemini" ]; then
  46. platforms="$platforms gemini"
  47. fi
  48. # Kiro
  49. if [ -d "$HOME/.kiro" ]; then
  50. platforms="$platforms kiro"
  51. fi
  52. # Cline
  53. if [ -d "$HOME/.cline" ]; then
  54. platforms="$platforms cline"
  55. fi
  56. # Roo Code
  57. if [ -d "$HOME/.roo" ]; then
  58. platforms="$platforms roo-code"
  59. fi
  60. # Kilo Code
  61. if [ -d "$HOME/.kilocode" ]; then
  62. platforms="$platforms kilo-code"
  63. fi
  64. # Factory Droid
  65. if [ -d "$HOME/.factory" ]; then
  66. platforms="$platforms factory"
  67. fi
  68. # Cursor
  69. if [ -d "$HOME/.cursor" ]; then
  70. platforms="$platforms cursor"
  71. fi
  72. # Goose
  73. if [ -d "$HOME/.config/goose" ]; then
  74. platforms="$platforms goose"
  75. fi
  76. # OpenCode
  77. if [ -d "$HOME/.config/opencode" ]; then
  78. platforms="$platforms opencode"
  79. fi
  80. echo "$platforms"
  81. }
  82. # ---------------------------------------------------------------------------
  83. # Resolve user-level install path for a platform
  84. # ---------------------------------------------------------------------------
  85. platform_path() {
  86. case "$1" in
  87. claude-code) echo "$HOME/.claude/skills/$SKILL_NAME" ;;
  88. github-copilot) echo "$HOME/.copilot/skills/$SKILL_NAME" ;;
  89. gemini) echo "$HOME/.gemini/skills/$SKILL_NAME" ;;
  90. kiro) echo "$HOME/.kiro/skills/$SKILL_NAME" ;;
  91. cline) echo "$HOME/.cline/skills/$SKILL_NAME" ;;
  92. roo-code) echo "$HOME/.roo/skills/$SKILL_NAME" ;;
  93. kilo-code) echo "$HOME/.kilocode/skills/$SKILL_NAME" ;;
  94. factory) echo "$HOME/.factory/skills/$SKILL_NAME" ;;
  95. cursor) echo "$HOME/.cursor/rules/$SKILL_NAME" ;;
  96. goose) echo "$HOME/.config/goose/skills/$SKILL_NAME" ;;
  97. opencode) echo "$HOME/.config/opencode/skills/$SKILL_NAME" ;;
  98. esac
  99. }
  100. # ---------------------------------------------------------------------------
  101. # Friendly display name for a platform
  102. # ---------------------------------------------------------------------------
  103. platform_display() {
  104. case "$1" in
  105. claude-code) echo "Claude Code" ;;
  106. github-copilot) echo "GitHub Copilot" ;;
  107. gemini) echo "Gemini CLI" ;;
  108. kiro) echo "Kiro" ;;
  109. cline) echo "Cline" ;;
  110. roo-code) echo "Roo Code" ;;
  111. kilo-code) echo "Kilo Code" ;;
  112. factory) echo "Factory Droid" ;;
  113. cursor) echo "Cursor" ;;
  114. goose) echo "Goose" ;;
  115. opencode) echo "OpenCode" ;;
  116. esac
  117. }
  118. # ---------------------------------------------------------------------------
  119. # Create a symlink (with fallback to copy)
  120. # ---------------------------------------------------------------------------
  121. create_symlink() {
  122. target="$1" # what the link points to
  123. link_path="$2" # where the link lives
  124. # Skip if target and link are the same path
  125. if [ "$target" = "$link_path" ]; then
  126. return 0
  127. fi
  128. mkdir -p "$(dirname "$link_path")"
  129. # Remove existing (file, symlink, or directory)
  130. if [ -e "$link_path" ] || [ -L "$link_path" ]; then
  131. rm -rf "$link_path"
  132. fi
  133. if ln -s "$target" "$link_path" 2>/dev/null; then
  134. return 0
  135. else
  136. warn "Symlink failed for $link_path — falling back to copy"
  137. cp -R "$target" "$link_path"
  138. fi
  139. }
  140. # ---------------------------------------------------------------------------
  141. # Main
  142. # ---------------------------------------------------------------------------
  143. main() {
  144. printf "\n${BOLD}Agent Skills Platform — Bootstrap Installer${NC}\n\n"
  145. # Check for git
  146. if ! command -v git >/dev/null 2>&1; then
  147. warn "git is not installed. Please install git and try again."
  148. exit 1
  149. fi
  150. # Clone or update the canonical location
  151. if [ -d "$CANONICAL_DIR/.git" ]; then
  152. info "Updating existing install at $CANONICAL_DIR"
  153. cd "$CANONICAL_DIR" && git pull --ff-only 2>/dev/null || true
  154. else
  155. info "Cloning $SKILL_NAME to $CANONICAL_DIR"
  156. mkdir -p "$(dirname "$CANONICAL_DIR")"
  157. rm -rf "$CANONICAL_DIR"
  158. git clone "$REPO_URL" "$CANONICAL_DIR"
  159. fi
  160. success "Installed at $CANONICAL_DIR"
  161. # Detect global platforms and create symlinks
  162. platforms="$(detect_global_platforms)"
  163. installed=""
  164. count=0
  165. for platform in $platforms; do
  166. dest="$(platform_path "$platform")"
  167. create_symlink "$CANONICAL_DIR" "$dest"
  168. name="$(platform_display "$platform")"
  169. success "Symlinked for $name → $dest"
  170. installed="$installed $name,"
  171. count=$((count + 1))
  172. done
  173. # ---------------------------------------------------------------------------
  174. # Summary
  175. # ---------------------------------------------------------------------------
  176. printf "\n${BOLD}Done!${NC}\n\n"
  177. printf " Canonical location: ${BOLD}%s${NC}\n" "$CANONICAL_DIR"
  178. if [ $count -gt 0 ]; then
  179. # Trim trailing comma
  180. installed="$(echo "$installed" | sed 's/,$//')"
  181. printf " Symlinked to %d platform(s):%s\n" "$count" "$installed"
  182. fi
  183. printf "\n${BOLD}How to use:${NC}\n"
  184. printf " Open your AI agent and type:\n"
  185. printf " /agent-skills-platform <describe your workflow>\n\n"
  186. printf " To update later:\n"
  187. printf " cd %s && git pull\n\n" "$CANONICAL_DIR"
  188. if [ $count -eq 0 ]; then
  189. warn "No global platforms detected. The skill is installed at the universal path."
  190. printf " Tools like Codex CLI, Gemini CLI, Kiro, and others\n"
  191. printf " read from ~/.agents/skills/ automatically.\n\n"
  192. fi
  193. }
  194. main

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.