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
Markdown
[](/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)
- {
- "$schema": "https://anthropic.com/claude-code/marketplace.schema.json",
- "name": "agent-skills-platform",
- "description": "Turn any workflow into reusable AI agent software that installs on 17 platforms.",
- "owner": {
- "name": "Francy Lisboa Charuto",
- "url": "https://github.com/FrancyJGLisboa"
- },
- "plugins": [
- {
- "name": "agent-skills-platform",
- "source": "./",
- "description": "Skill factory: describe a workflow in plain English and receive a validated, security-scanned cross-platform agent skill with evals and an installer.",
- "category": "productivity"
- }
- ]
- }
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)
- # Agent Skills Platform
- **Turn a real workflow into a tested, installable agent skill—then publish it safely to your team.**
- 
- [](https://github.com/FrancyJGLisboa/agent-skills-platform/actions/workflows/ci.yml)
- [](https://github.com/agentskills/agentskills/blob/main/docs/specification.mdx)
- [](docs/INSTALL.md)
- []()
- []()
- [Website](https://francyjglisboa.github.io/agent-skills-platform/) ·
- [Installation](docs/INSTALL.md) ·
- [Worker runbook](docs/WORKER_RUNBOOK.md) ·
- [Team marketplace](docs/TEAM_MARKETPLACE.md) ·
- [Product scope](docs/PRODUCT_SCOPE.md)
- Agent Skills Platform turns the way people already work into tested, installable agent
- skills. Give it a prompt plus the evidence behind the work—spreadsheets, reports,
- emails, screenshots, transcripts, links, or scripts—and it builds a reusable workflow
- that a person can inspect, an organization can review, and a team can safely reuse.
- ```text
- /agent-skills-platform
- Turn my monthly revenue-variance review into a reusable internal skill.
- I attached past reports and the source spreadsheets. The decision is whether to
- escalate a material variance. It must not modify source data.
- ```
- The result is not just a prompt: it is an installable skill package with instructions,
- functional scripts when needed, evals, security checks, a representative-run record,
- and a correction path for real-world learning.
- After release, a skill can retain maintenance evidence without turning every log
- into runtime prompt context: classified run evidence is captured in `raw/`, recurring
- findings become evidence-linked draft patterns in `wiki/`, and only a separately
- validated change may update the executable skill. This is a governed maintenance
- record, not autonomous self-modification.
- ## Create your first skill
- Choose the path that matches what you need today.
- **First question:** is this skill just for you, or will teammates install or reuse the
- skill itself?
- - **Just for you** — create, verify, and install it privately. No marketplace setup.
- - **My team** — create or select a governed GitHub/GitLab marketplace first, so the
- skill inherits real ownership and approval rules.
- Teammates receiving a report or queue does not require a marketplace. Use the team
- path only when teammates will install or reuse the skill.
- ### I have a workflow — no code required
- Open the AI agent you already use, attach examples of the work, and paste this:
- ```text
- /agent-skills-platform
- Turn my monthly revenue-variance review into a reusable internal skill.
- I attached past reports and the source spreadsheets. The decision is whether to
- escalate a material variance. It must not modify source data.
- ```
- The creator asks for the business decisions only you can authorize, builds and tests
- the skill, and shows a representative result. When it is correct, say: **“Publish
- this to the Finance marketplace.”**
- When the workflow uses an API, database, MCP, codebase, or structured file, Semantic
- Recon runs automatically before implementation and creates a pinned data contract.
- Use `./install.sh --without-semantic-recon` only for a deliberately local,
- source-free installation.
- Do not use Git, edit registry files, or run marketplace commands. If the creator is
- not installed in your agent, send this section to your marketplace operator.
- ### My teammates just need to install skills
- Give them the [desktop app](docs/DESKTOP_APP.md): download, paste the team-library
- link, click Install. Skills land in GitHub Copilot (or the tool they pick) with no
- terminal, Python, or Git involved. The same page shows admins how to create a
- library in four commands.
- ### I run the marketplace
- Use the [governed team marketplace guide](docs/TEAM_MARKETPLACE.md) to admit,
- approve, release, distribute, update, quarantine, and roll back tested skills.
- ### I am evaluating the platform
- Read the [product scope](docs/PRODUCT_SCOPE.md),
- [organizational acceptance protocol](docs/ORGANIZATIONAL_ACCEPTANCE.md), and
- [technical implementation guide](docs/TECHNICAL_OVERVIEW.md).
- ## Why teams use it
- - **Preserve expert judgment.** A skill captures the question, evidence, decision,
- and success measure behind recurring work.
- - **Trust what is shared.** Skills carry validation, security checks, evals, and a
- representative run before they are published; for Claude Code and Codex the
- marketplace can also certify a skill from real agent runs (`reliability`).
- - **Learn without runtime bloat.** Maintenance keeps evidence, draft patterns, and
- rejected changes separate from the concise instructions an agent executes.
- - **Govern team use.** The marketplace provides ownership, approvals, versioned
- releases, discovery, rollback, quarantine, and compatibility evidence.
- ## How work moves through the organization
- ```text
- SME supplies examples and approves the result
- ↓
- Creator builds and verifies a skill
- ↓
- Marketplace operator governs and publishes it
- ↓
- Colleagues install an approved version and use it
- ```
- The SME owns business meaning. The marketplace operator owns distribution and policy.
- See [roles and handoffs](docs/TEAM_MARKETPLACE.md#roles-and-handoffs).
- ## See a verified result
- The repository includes a live, read-only weather briefing example with a source-linked
- result and verification evidence. Start with the
- [verification record](docs/verification/2026-08-27-live-weather-briefing.md), then
- inspect the [skill package](references/examples/live-weather-briefing-skill).
- ## Read more when needed
- | Need | Read |
- |---|---|
- | Install on a supported AI tool | [Installation](docs/INSTALL.md) |
- | Let non-technical teammates browse and install skills | [Desktop app](docs/DESKTOP_APP.md) |
- | Create, correct, and hand off a first skill | [Worker runbook](docs/WORKER_RUNBOOK.md) |
- | Run a governed internal marketplace | [Team marketplace](docs/TEAM_MARKETPLACE.md) |
- | Test a skill inside a real agent and certify it per runtime | [Caliper pilot](docs/CALIPER.md) |
- | Understand scope and product boundaries | [Product scope](docs/PRODUCT_SCOPE.md) |
- | Review architecture, validation, and technical controls | [Technical overview](docs/TECHNICAL_OVERVIEW.md) |
- | Contribute | [Contributing](CONTRIBUTING.md) |
- ## What happens behind the scenes
- An Agent Skill is a reusable workflow package that guides an agent from a
- recognized situation to a verified outcome. It can use retrieved knowledge, MCP
- tools, APIs, deterministic scripts, and agent judgment, but it is not itself a
- RAG system, MCP server, or agent runtime.
- RAG supplies knowledge. MCP supplies capabilities. The harness supplies
- execution. A skill organizes them into a governed path toward a verified
- outcome.
- Reason where interpretation is necessary. Execute and verify with deterministic
- controls where reproducibility matters. External models, APIs, and changing data
- may vary rather than promising identical outputs.
- Humans establish meaning. The factory does not expect you to know the correct
- prompt or semantic contract; it asks one bounded question at a time. The flow is:
- - Messy problem
- - Agent inspects evidence
- - Proposed / conflicting meanings
- - Human authority decision
- - Interview READY
- - Build, prove, publish
- Every skill is checked as one connected system. The skill graph links its
- instructions, scripts, evaluations, and expected outputs. Two structural
- requirements confirm that every expected result is tested and every predictable
- multi-step workflow has one reliable entry point. Four checks—specification,
- pipeline, security, and evaluation schema—run in parallel. Finally, a
- representative run proves that the skill produces a useful result. The graph also
- enforces `every_expected_is_reachable` and `deterministic_multistep_has_orchestrator`.
- After intake, `team_marketplace.py reliability` can run the skill inside each installed
- agent runtime k times and certify only what an agent actually discovered and followed
- ([Caliper](docs/CALIPER.md)).
- See [CONTRIBUTING.md](CONTRIBUTING.md) and [CODE_OF_CONDUCT.md](CODE_OF_CONDUCT.md).
- Contributions require the [contributor assignment](CONTRIBUTOR_ASSIGNMENT.md).
- ## License
- MIT. See [LICENSE](LICENSE). Copyright © 2026 Francy J G Lisboa, also known as
- Charuto. See [ownership](COPYRIGHT.md).
scripts/bootstrap.bat · Bundled script · 29 lines · 1 finding marked
- @echo off
- REM bootstrap.bat — One-liner bootstrap for agent-skills-platform (Windows CMD)
- REM
- REM Usage (paste into Command Prompt):
- REM curl -fsSL https://raw.githubusercontent.com/FrancyJGLisboa/agent-skills-platform/main/scripts/bootstrap.bat -o %TEMP%\bootstrap.bat && %TEMP%\bootstrap.bat
- REM
- REM This is a thin wrapper that launches the PowerShell bootstrap script.
- echo.
- echo Agent Skills Platform - Bootstrap Installer
- echo.
- REM Check if PowerShell is available
- where powershell >nul 2>&1
- if %ERRORLEVEL% neq 0 (
- echo [ERROR] PowerShell is not available on this system.
- echo Please install PowerShell or use the PowerShell one-liner instead.
- echo https://learn.microsoft.com/en-us/powershell/scripting/install/installing-powershell-on-windows
- exit /b 1
- )
- REM Run the PowerShell bootstrap directly from GitHub
- 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 23 on GitHub
- if %ERRORLEVEL% neq 0 (
- echo.
- echo [ERROR] Installation failed. See errors above.
- exit /b 1
- )
scripts/bootstrap.ps1 · Bundled script · 239 lines · 2 findings marked
- # bootstrap.ps1 — One-liner bootstrap for agent-skills-platform (Windows)
- #
- # Usage (PowerShell):
- # 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
- #
- # Usage (Command Prompt):
- # 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
- #
- # Clones agent-skills-platform to ~/.agents/skills/ and creates junctions/symlinks
- # to all detected global platforms. Works on PowerShell 5.1+ and PowerShell Core 7+.
- $ErrorActionPreference = "Stop"
- # ---------------------------------------------------------------------------
- # Constants
- # ---------------------------------------------------------------------------
- $RepoUrl = "https://github.com/FrancyJGLisboa/agent-skills-platform.git"
- $SkillName = "agent-skills-platform"
- $HomeDir = $env:USERPROFILE
- $CanonicalDir = Join-Path $HomeDir ".agents" "skills" $SkillName
- # ---------------------------------------------------------------------------
- # Logging helpers
- # ---------------------------------------------------------------------------
- function Write-Info { param($msg) Write-Host "[INFO] $msg" -ForegroundColor Blue }
- function Write-Ok { param($msg) Write-Host "[OK] $msg" -ForegroundColor Green }
- function Write-Warn { param($msg) Write-Host "[WARN] $msg" -ForegroundColor Yellow }
- function Write-Err { param($msg) Write-Host "[ERROR] $msg" -ForegroundColor Red }
- # ---------------------------------------------------------------------------
- # Check for git
- # ---------------------------------------------------------------------------
- function Test-GitInstalled {
- try {
- $null = Get-Command git -ErrorAction Stop
- return $true
- } catch {
- return $false
- }
- }
- # ---------------------------------------------------------------------------
- # Create a directory junction (works without admin on Windows)
- # Falls back to copying if junctions fail.
- # ---------------------------------------------------------------------------
- function New-SkillLink {
- param(
- [string]$Target,
- [string]$LinkPath
- )
- if ($Target -eq $LinkPath) { return }
- $parentDir = Split-Path $LinkPath -Parent
- if (-not (Test-Path $parentDir)) {
- New-Item -ItemType Directory -Path $parentDir -Force | Out-Null
- }
- # Remove existing item
- if (Test-Path $LinkPath) {
- Remove-Item $LinkPath -Recurse -Force
- }
- # Try directory junction first (no admin required)
- try {
- cmd /c mklink /J "`"$LinkPath`"" "`"$Target`"" 2>$null | Out-Null
- if (Test-Path $LinkPath) {
- return
- }
- } catch {}
- # Try symbolic link (may need admin)
- try {
- New-Item -ItemType SymbolicLink -Path $LinkPath -Target $Target -Force | Out-Null
- if (Test-Path $LinkPath) {
- return
- }
- } catch {}
- # Fallback: copy
- Write-Warn "Junction/symlink failed for $LinkPath - falling back to copy"
- Copy-Item -Path $Target -Destination $LinkPath -Recurse -Force
- }
- # ---------------------------------------------------------------------------
- # Detect globally-installed platforms (user-level only)
- # ---------------------------------------------------------------------------
- function Get-DetectedPlatforms {
- $platforms = @()
- $checks = @(
- @{ Dir = ".claude"; Name = "claude-code"; Display = "Claude Code" },
- @{ Dir = ".copilot"; Name = "github-copilot"; Display = "GitHub Copilot" },
- @{ Dir = ".gemini"; Name = "gemini"; Display = "Gemini CLI" },
- @{ Dir = ".kiro"; Name = "kiro"; Display = "Kiro" },
- @{ Dir = ".cline"; Name = "cline"; Display = "Cline" },
- @{ Dir = ".roo"; Name = "roo-code"; Display = "Roo Code" },
- @{ Dir = ".kilocode"; Name = "kilo-code"; Display = "Kilo Code" },
- @{ Dir = ".factory"; Name = "factory"; Display = "Factory Droid" },
- @{ Dir = ".cursor"; Name = "cursor"; Display = "Cursor" }
- )
- foreach ($check in $checks) {
- $testPath = Join-Path $HomeDir $check.Dir
- if (Test-Path $testPath) {
- $platforms += $check
- }
- }
- # Config-based paths (Goose, OpenCode)
- $configDir = Join-Path $HomeDir ".config"
- if (Test-Path (Join-Path $configDir "goose")) {
- $platforms += @{ Dir = ".config/goose"; Name = "goose"; Display = "Goose" }
- }
- if (Test-Path (Join-Path $configDir "opencode")) {
- $platforms += @{ Dir = ".config/opencode"; Name = "opencode"; Display = "OpenCode" }
- }
- # Also check Windows-native AppData paths
- $appData = $env:APPDATA
- if ($appData) {
- if (Test-Path (Join-Path $appData "Claude")) {
- # Claude Desktop on Windows
- $platforms += @{ Dir = "AppData/Claude"; Name = "claude-desktop"; Display = "Claude Desktop" }
- }
- }
- return $platforms
- }
- # ---------------------------------------------------------------------------
- # Resolve install path for a platform
- # ---------------------------------------------------------------------------
- function Get-PlatformPath {
- param([string]$PlatformName)
- switch ($PlatformName) {
- "claude-code" { return Join-Path $HomeDir ".claude" "skills" $SkillName }
- "github-copilot" { return Join-Path $HomeDir ".copilot" "skills" $SkillName }
- "gemini" { return Join-Path $HomeDir ".gemini" "skills" $SkillName }
- "kiro" { return Join-Path $HomeDir ".kiro" "skills" $SkillName }
- "cline" { return Join-Path $HomeDir ".cline" "skills" $SkillName }
- "roo-code" { return Join-Path $HomeDir ".roo" "skills" $SkillName }
- "kilo-code" { return Join-Path $HomeDir ".kilocode" "skills" $SkillName }
- "factory" { return Join-Path $HomeDir ".factory" "skills" $SkillName }
- "cursor" { return Join-Path $HomeDir ".cursor" "rules" $SkillName }
- "goose" { return Join-Path $HomeDir ".config" "goose" "skills" $SkillName }
- "opencode" { return Join-Path $HomeDir ".config" "opencode" "skills" $SkillName }
- default { return Join-Path $HomeDir ".agents" "skills" $SkillName }
- }
- }
- # ---------------------------------------------------------------------------
- # Main
- # ---------------------------------------------------------------------------
- function Main {
- Write-Host ""
- Write-Host "Agent Skills Platform - Bootstrap Installer (Windows)" -ForegroundColor White -NoNewline
- Write-Host ""
- Write-Host ""
- # Check for git
- if (-not (Test-GitInstalled)) {
- Write-Err "git is not installed."
- Write-Host ""
- Write-Host "Install git from: https://git-scm.com/downloads/win" -ForegroundColor Yellow
- Write-Host ""
- Write-Host "Or with winget: winget install Git.Git" -ForegroundColor Yellow
- Write-Host "Or with choco: choco install git" -ForegroundColor Yellow
- Write-Host ""
- exit 1
- }
- # Clone or update the canonical location
- if (Test-Path (Join-Path $CanonicalDir ".git")) {
- Write-Info "Updating existing install at $CanonicalDir"
- Push-Location $CanonicalDir
- try { git pull --ff-only 2>$null } catch {}
- Pop-Location
- } else {
- Write-Info "Cloning $SkillName to $CanonicalDir"
- $parentDir = Split-Path $CanonicalDir -Parent
- if (-not (Test-Path $parentDir)) {
- New-Item -ItemType Directory -Path $parentDir -Force | Out-Null
- }
- if (Test-Path $CanonicalDir) {
- Remove-Item $CanonicalDir -Recurse -Force
- }
- git clone $RepoUrl $CanonicalDir
- if ($LASTEXITCODE -ne 0) {
- Write-Err "git clone failed. Check your internet connection and try again."
- exit 1
- }
- }
- Write-Ok "Installed at $CanonicalDir"
- # Detect global platforms and create junctions
- $platforms = Get-DetectedPlatforms
- $count = 0
- foreach ($platform in $platforms) {
- $dest = Get-PlatformPath $platform.Name
- New-SkillLink -Target $CanonicalDir -LinkPath $dest
- Write-Ok "Linked for $($platform.Display) -> $dest"
- $count++
- }
- # ---------------------------------------------------------------------------
- # Summary
- # ---------------------------------------------------------------------------
- Write-Host ""
- Write-Host "Done!" -ForegroundColor Green
- Write-Host ""
- Write-Host " Canonical location: $CanonicalDir"
- if ($count -gt 0) {
- $names = ($platforms | ForEach-Object { $_.Display }) -join ", "
- Write-Host " Linked to $count platform(s): $names"
- }
- Write-Host ""
- Write-Host "How to use:" -ForegroundColor White
- Write-Host " Open your AI agent and type:"
- Write-Host " /agent-skills-platform <describe your workflow>"
- Write-Host ""
- Write-Host " To update later:"
- Write-Host " cd $CanonicalDir; git pull"
- Write-Host ""
- if ($count -eq 0) {
- Write-Warn "No global platforms detected. The skill is installed at the universal path."
- Write-Host " Tools like Codex CLI, Gemini CLI, Kiro, and others"
- Write-Host " read from ~/.agents/skills/ automatically."
- Write-Host ""
- }
- }
- Main
scripts/bootstrap.sh · Bundled script · 217 lines · 1 finding marked
- #!/bin/sh
- # bootstrap.sh — One-liner bootstrap for agent-skills-platform
- #
- # Usage:
- # 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
- #
- # Clones agent-skills-platform to ~/.agents/skills/ and symlinks to all detected
- # global platforms. POSIX-compatible (works in bash, dash, zsh, ash).
- set -eu
- # ---------------------------------------------------------------------------
- # Constants
- # ---------------------------------------------------------------------------
- REPO_URL="https://github.com/FrancyJGLisboa/agent-skills-platform.git"
- SKILL_NAME="agent-skills-platform"
- CANONICAL_DIR="$HOME/.agents/skills/$SKILL_NAME"
- # ---------------------------------------------------------------------------
- # Colors (disabled when stdout is not a terminal)
- # ---------------------------------------------------------------------------
- if [ -t 1 ]; then
- GREEN='\033[0;32m'
- YELLOW='\033[1;33m'
- BLUE='\033[0;34m'
- BOLD='\033[1m'
- NC='\033[0m'
- else
- GREEN='' YELLOW='' BLUE='' BOLD='' NC=''
- fi
- info() { printf "${BLUE}[INFO]${NC} %s\n" "$1"; }
- success() { printf "${GREEN}[OK]${NC} %s\n" "$1"; }
- warn() { printf "${YELLOW}[WARN]${NC} %s\n" "$1"; }
- # ---------------------------------------------------------------------------
- # Detect globally-installed platforms (user-level only, skip project-level)
- # ---------------------------------------------------------------------------
- detect_global_platforms() {
- platforms=""
- # Claude Code
- if [ -d "$HOME/.claude" ]; then
- platforms="$platforms claude-code"
- fi
- # GitHub Copilot
- if [ -d "$HOME/.copilot" ]; then
- platforms="$platforms github-copilot"
- fi
- # Gemini CLI
- if [ -d "$HOME/.gemini" ]; then
- platforms="$platforms gemini"
- fi
- # Kiro
- if [ -d "$HOME/.kiro" ]; then
- platforms="$platforms kiro"
- fi
- # Cline
- if [ -d "$HOME/.cline" ]; then
- platforms="$platforms cline"
- fi
- # Roo Code
- if [ -d "$HOME/.roo" ]; then
- platforms="$platforms roo-code"
- fi
- # Kilo Code
- if [ -d "$HOME/.kilocode" ]; then
- platforms="$platforms kilo-code"
- fi
- # Factory Droid
- if [ -d "$HOME/.factory" ]; then
- platforms="$platforms factory"
- fi
- # Cursor
- if [ -d "$HOME/.cursor" ]; then
- platforms="$platforms cursor"
- fi
- # Goose
- if [ -d "$HOME/.config/goose" ]; then
- platforms="$platforms goose"
- fi
- # OpenCode
- if [ -d "$HOME/.config/opencode" ]; then
- platforms="$platforms opencode"
- fi
- echo "$platforms"
- }
- # ---------------------------------------------------------------------------
- # Resolve user-level install path for a platform
- # ---------------------------------------------------------------------------
- platform_path() {
- case "$1" in
- claude-code) echo "$HOME/.claude/skills/$SKILL_NAME" ;;
- github-copilot) echo "$HOME/.copilot/skills/$SKILL_NAME" ;;
- gemini) echo "$HOME/.gemini/skills/$SKILL_NAME" ;;
- kiro) echo "$HOME/.kiro/skills/$SKILL_NAME" ;;
- cline) echo "$HOME/.cline/skills/$SKILL_NAME" ;;
- roo-code) echo "$HOME/.roo/skills/$SKILL_NAME" ;;
- kilo-code) echo "$HOME/.kilocode/skills/$SKILL_NAME" ;;
- factory) echo "$HOME/.factory/skills/$SKILL_NAME" ;;
- cursor) echo "$HOME/.cursor/rules/$SKILL_NAME" ;;
- goose) echo "$HOME/.config/goose/skills/$SKILL_NAME" ;;
- opencode) echo "$HOME/.config/opencode/skills/$SKILL_NAME" ;;
- esac
- }
- # ---------------------------------------------------------------------------
- # Friendly display name for a platform
- # ---------------------------------------------------------------------------
- platform_display() {
- case "$1" in
- claude-code) echo "Claude Code" ;;
- github-copilot) echo "GitHub Copilot" ;;
- gemini) echo "Gemini CLI" ;;
- kiro) echo "Kiro" ;;
- cline) echo "Cline" ;;
- roo-code) echo "Roo Code" ;;
- kilo-code) echo "Kilo Code" ;;
- factory) echo "Factory Droid" ;;
- cursor) echo "Cursor" ;;
- goose) echo "Goose" ;;
- opencode) echo "OpenCode" ;;
- esac
- }
- # ---------------------------------------------------------------------------
- # Create a symlink (with fallback to copy)
- # ---------------------------------------------------------------------------
- create_symlink() {
- target="$1" # what the link points to
- link_path="$2" # where the link lives
- # Skip if target and link are the same path
- if [ "$target" = "$link_path" ]; then
- return 0
- fi
- mkdir -p "$(dirname "$link_path")"
- # Remove existing (file, symlink, or directory)
- if [ -e "$link_path" ] || [ -L "$link_path" ]; then
- rm -rf "$link_path"
- fi
- if ln -s "$target" "$link_path" 2>/dev/null; then
- return 0
- else
- warn "Symlink failed for $link_path — falling back to copy"
- cp -R "$target" "$link_path"
- fi
- }
- # ---------------------------------------------------------------------------
- # Main
- # ---------------------------------------------------------------------------
- main() {
- printf "\n${BOLD}Agent Skills Platform — Bootstrap Installer${NC}\n\n"
- # Check for git
- if ! command -v git >/dev/null 2>&1; then
- warn "git is not installed. Please install git and try again."
- exit 1
- fi
- # Clone or update the canonical location
- if [ -d "$CANONICAL_DIR/.git" ]; then
- info "Updating existing install at $CANONICAL_DIR"
- cd "$CANONICAL_DIR" && git pull --ff-only 2>/dev/null || true
- else
- info "Cloning $SKILL_NAME to $CANONICAL_DIR"
- mkdir -p "$(dirname "$CANONICAL_DIR")"
- rm -rf "$CANONICAL_DIR"
- git clone "$REPO_URL" "$CANONICAL_DIR"
- fi
- success "Installed at $CANONICAL_DIR"
- # Detect global platforms and create symlinks
- platforms="$(detect_global_platforms)"
- installed=""
- count=0
- for platform in $platforms; do
- dest="$(platform_path "$platform")"
- create_symlink "$CANONICAL_DIR" "$dest"
- name="$(platform_display "$platform")"
- success "Symlinked for $name → $dest"
- installed="$installed $name,"
- count=$((count + 1))
- done
- # ---------------------------------------------------------------------------
- # Summary
- # ---------------------------------------------------------------------------
- printf "\n${BOLD}Done!${NC}\n\n"
- printf " Canonical location: ${BOLD}%s${NC}\n" "$CANONICAL_DIR"
- if [ $count -gt 0 ]; then
- # Trim trailing comma
- installed="$(echo "$installed" | sed 's/,$//')"
- printf " Symlinked to %d platform(s):%s\n" "$count" "$installed"
- fi
- printf "\n${BOLD}How to use:${NC}\n"
- printf " Open your AI agent and type:\n"
- printf " /agent-skills-platform <describe your workflow>\n\n"
- printf " To update later:\n"
- printf " cd %s && git pull\n\n" "$CANONICAL_DIR"
- if [ $count -eq 0 ]; then
- warn "No global platforms detected. The skill is installed at the universal path."
- printf " Tools like Codex CLI, Gemini CLI, Kiro, and others\n"
- printf " read from ~/.agents/skills/ automatically.\n\n"
- fi
- }
- main
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.