Growthly Skills CLI

A command-line tool to manage AI agent skills for Claude Code, Gemini CLI, and other AI assistants.

Features

• ✨ Non-Destructive Merge Mode - Integrates with existing projects without destroying content
• 🎯 Interactive Skill Selection - Choose which skills to install during init or add them later
• 🔧 Automatic Setup - Creates folder structure and symlinks for multiple AI assistants
• 📝 Dynamic Documentation - Auto-generates AGENTS.md from skill metadata
• 🔄 Smart Sync - Keeps skills and documentation in sync across all assistants
• 🔒 Content Preservation - Uses HTML markers to manage only CLI-controlled sections
• 📦 Incremental Installation - Add new skills anytime with the add command
• 🗑️ Clean Management - Easily list, remove, or fully purge skills from your project

Installation

npm install -g growthly-skills-cli

Or use without installing:

npx growthly-skills-cli init

Quick Start

New Project

cd your-project
skillsync init

Existing Project (Non-Destructive)

cd existing-project-with-agents
skillsync init  # Automatically detects and merges

Commands

init - Initialize Workspace

skillsync init [options]

Options:

• -f, --force - Overwrite existing setup (destructive)
• -m, --merge - Explicitly enable merge mode (non-destructive)

What it creates:

your-project/
├── .growthly-sync/
│   └── skills/              # Skills source
│       ├── meta/
│       │   ├── skill-creator/
│       └── workflow/
│           └── project-planner/
├── .claude/
│   └── skills/              # Claude Code symlinks
├── .gemini/
│   └── skills/              # Gemini CLI symlinks
├── .codex/
│   └── skills/              # Codex (OpenAI) symlinks
├── AGENTS.md                # Main documentation
├── CLAUDE.md                # Claude-specific copy
└── GEMINI.md                # Gemini-specific copy

add - Add Skills to Project

skillsync add [options]

Options:

• -d, --department <department> - Target specific department (meta, workflow, etc.)
• -a, --all - Install all available skills without prompts

Interactive Mode (no flags):

skillsync add

• Browse skills by department
• Select specific skills using:
  • Install all from department
  • Choose by numbers (e.g., 1,3,4)
  • Interactive checklist

list - List Installed Skills

skillsync list

Displays all currently installed skills grouped by department.

remove - Remove Skills

skillsync remove [options]

Options:

• -a, --all - Remove ALL installed skills (prompts for confirmation unless --yes is used)
• -y, --yes - Skip confirmation prompts

Interactive Mode (no flags): Allows you to select specific skills to remove from a checklist.

purge - Uninstall CLI Setup

skillsync purge [options]

Options:

• -y, --yes - Skip confirmation prompts

What it does:

• Removes the .growthly-sync/ directory
• Removes CLI-managed symlinks from .claude/, .gemini/, etc.
• Cleans CLI-managed sections from AGENTS.md (preserves your custom content)
• Safe: Does not touch your custom files or protected content.

sync - Sync Skills and Documentation

skillsync sync [options]

Options:

• -d, --dry-run - Preview changes without modifying files
• -s, --scope <scope> - Sync specific scope (root, ui, api, sdk, mcp_server)

What it does:

• Updates AGENTS.md with latest skill metadata
• Refreshes symlinks in .claude/, .gemini/, .codex/
• Synchronizes CLAUDE.md and GEMINI.md
• Preserves all user content outside markers

Non-Destructive Merge Mode

The CLI automatically detects existing setups and uses merge mode to integrate without destroying your content.

How It Works

HTML Markers: The CLI uses HTML comments to mark sections it manages:

# Your Custom Content (preserved)

<!-- growthly-skills-cli:available-skills:start -->

## Available Skills

[CLI manages this section]

<!-- growthly-skills-cli:available-skills:end -->

<!-- growthly-skills-cli:auto-invoke:start -->

### Auto-invoke Skills

[CLI manages this section]

<!-- growthly-skills-cli:auto-invoke:end -->

# More Custom Content (preserved)

What's Preserved:

• ✅ All content outside HTML markers
• ✅ Your custom symlinks and folders
• ✅ Custom CLAUDE.md/GEMINI.md (if they don't have markers)
• ✅ Existing skills in .growthly-sync/skills/

What's Updated:

• ✅ Content between CLI markers
• ✅ Symlinks pointing to .growthly-sync/skills/
• ✅ Skill metadata in AGENTS.md

Included Skills

🔧 Meta (Internal Tooling)

• skill-creator - Creates new AI agent skills with templates
• skill-sync - Syncs skill metadata and symlinks

🔄 Workflow (DevOps & Processes)

• project-planner - Creates phased implementation plans
• task-executor - Executing tasks efficiently
• task-planner - Planning tasks efficiently

Adding Custom Skills

1. Create a skill in .growthly-sync/skills/your-department/your-skill/
2. Add a SKILL.md file with frontmatter:

---
name: your-skill
description: What your skill does
metadata:
  author: your-name
  version: "1.0"
  scope: [root]
  auto_invoke:
    - "When to trigger this skill"
---
## Your skill content

3. Run sync:

skillsync sync

Your skill will automatically appear in AGENTS.md and be symlinked to all AI assistant folders!

Debug Mode

Enable detailed logging:

DEBUG=1 skillsync init
DEBUG=1 skillsync sync

Requirements

• Node.js 18+
• npm or npx
• Git (optional, for version control)

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

Apache-2.0

Author

growthly-skills-cli

Need help? Check the documentation or open an issue on GitHub.