help-me-ai
CLI tool to discover and install AI coding assistant skills based on your project dependencies.
Installation
# Run directly with npx
npx @bam.tech/help-me-ai
# Or install globally
npm install -g @bam.tech/help-me-ai
npx @bam.tech/help-me-ai
# Or install globally
npm install -g @bam.tech/help-me-ai
Usage
Navigate to your project directory and run:
npx @bam.tech/help-me-ai
The CLI will:
- Scan your
package.jsonfor dependencies - Match them against available skills in the registry
- Present an interactive selection of matching skills
- Download and install selected skills to
.cursor/skills/{skill-name}/SKILL.mdor.claude/skills/{skill-name}/SKILL.md
Options
help-me-ai [options]
Options:
-d, --directory <path> Project directory to analyze (default: current directory)
-r, --registry <url> Custom skills registry URL
--all Install all matching skills without prompting
--list List matching skills without installing
-V, --version Output version number
-h, --help Display help
Options:
-d, --directory <path> Project directory to analyze (default: current directory)
-r, --registry <url> Custom skills registry URL
--all Install all matching skills without prompting
--list List matching skills without installing
-V, --version Output version number
-h, --help Display help
Examples
# Analyze current directory
npx @bam.tech/help-me-ai
# Analyze a specific directory
npx @bam.tech/help-me-ai -d /path/to/project
# List available skills without installing
npx @bam.tech/help-me-ai --list
# Install all matching skills
npx @bam.tech/help-me-ai --all
# Use a custom registry
npx @bam.tech/help-me-ai -r https://raw.githubusercontent.com/myorg/my-skills/main
npx @bam.tech/help-me-ai
# Analyze a specific directory
npx @bam.tech/help-me-ai -d /path/to/project
# List available skills without installing
npx @bam.tech/help-me-ai --list
# Install all matching skills
npx @bam.tech/help-me-ai --all
# Use a custom registry
npx @bam.tech/help-me-ai -r https://raw.githubusercontent.com/myorg/my-skills/main
How It Works
The CLI reads your project's dependencies and matches them against a skills registry. Skills are version-aware, so you'll only see skills compatible with your installed library versions.
Supported Package Managers
- npm / yarn / pnpm / bun (via
package.json) - More coming soon (Cargo.toml, requirements.txt, etc.)
Target Directories
The CLI automatically detects which AI assistant you're using and installs skills in the standard folder structure:
- Cursor: Skills are installed to
.cursor/skills/{skill-name}/SKILL.md - Claude: Skills are installed to
.claude/skills/{skill-name}/SKILL.md(project-specific skills)
Each skill is installed in its own folder following the Agent Skills standard format.
Creating Custom Skills
See the skills repository for documentation on creating and contributing skills.
Skills Registry Format
The registry uses an index.json file with semver ranges for version matching:
{
"version": "1.0.0",
"skills": [
{
"id": "react-query-v5",
"name": "React Query Best Practices",
"description": "TanStack Query v5 patterns and best practices",
"library": "@tanstack/react-query",
"versionRange": ">=5.0.0",
"path": "skills/react-query-v5"
}
]
}
"version": "1.0.0",
"skills": [
{
"id": "react-query-v5",
"name": "React Query Best Practices",
"description": "TanStack Query v5 patterns and best practices",
"library": "@tanstack/react-query",
"versionRange": ">=5.0.0",
"path": "skills/react-query-v5"
}
]
}
Development
# Install dependencies
bun install
# Build
bun run build
# Run locally
node dist/index.js
bun install
# Build
bun run build
# Run locally
node dist/index.js
License
MIT