Universal Skills loader for AI Coding Agents - The #1 CLI for AI Agent Skills
npm install ralphy-skillsbash
Use with npx (no installation needed)
npx ralphy-skills doctor
Or install globally
npm install -g ralphy-skills
`
š©ŗ Quick Start
`bash
1. Diagnose your environment
npx ralphy-skills doctor
2. Initialize your project
npx ralphy-skills init
3. Install skills
npx ralphy-skills install vercel-react-best-practices
4. Sync AGENTS.md
npx ralphy-skills sync
`
š Commands
$3
| Command | Description |
|---------|-------------|
| install | Install a skill by name, URL, or local path |
| list | List installed skills |
| list --registry | Browse available skills from registry |
| search | Search for skills |
| update | Update all installed skills |
| remove | Remove a skill |
| manage | Interactive TUI for skill management |
$3
| Command | Description |
|---------|-------------|
| sync | Update AGENTS.md with installed skills |
| read | Read skill content to stdout (for AI agents) |
| export --all | Export skills to all detected AI tools |
| doctor | Diagnose environment and detect AI tools |
$3
| Command | Description |
|---------|-------------|
| init | Initialize project with skill support |
| create | Create a new skill from template |
| validate | Validate skill format and structure |
$3
| Command | Description |
|---------|-------------|
| enable | Enable a disabled skill |
| disable | Disable a skill without removing |
| toggle | Interactive skill enable/disable |
| lock | Generate lock file for reproducible installations |
| lock restore | Restore skills from lock file |
| import | Import skills from manifest file |
| config | Manage CLI configuration |
š©ŗ Doctor Command
Diagnose your environment and detect installed AI coding tools:
`bash
npx ralphy-skills doctor
`
Output:
`
š©ŗ Ralphy Skills Doctor
š Detected AI Coding Tools:
ā
š±ļø Cursor (v1.2.3)
Skills path: .cursor/rules
ā
š¤ Claude Code
Skills path: .claude/skills
š Environment Summary:
š Project: /path/to/project
š¦ Skills Directory: ā exists
š AGENTS.md: ā exists
š¢ Installed Skills: 5
š” Recommendations:
ā¢ Run 'npx ralphy-skills sync' to update AGENTS.md
`
š¤ Multi-Agent Export
Export skills to all your AI coding tools at once:
`bash
Export to all detected tools
npx ralphy-skills export --all
Export to specific tools
npx ralphy-skills export --cursor --claude --copilot
Preview without changes
npx ralphy-skills export --all --dry-run
`
š Lock Files
Create reproducible skill installations (like package-lock.json):
`bash
Generate lock file
npx ralphy-skills lock
Restore from lock file
npx ralphy-skills lock restore
Check lock file status
npx ralphy-skills lock check
`
š„ Bulk Import
Import multiple skills from a manifest file:
`bash
Import from skills.json
npx ralphy-skills import skills.json
Generate manifest from installed skills
npx ralphy-skills import --generate
`
skills.json format:
`json
{
"skills": [
{ "url": "https://github.com/user/repo/skills/my-skill" },
{ "id": "vercel-react-best-practices" }
]
}
`
āļø Configuration
Manage global CLI settings:
`bash
Show all settings
npx ralphy-skills config list
Set a value
npx ralphy-skills config set defaultScope universal
Interactive editor
npx ralphy-skills config edit
`
Available settings:
- defaultScope - Where to install skills (universal|global|project)
- autoSync - Auto-sync AGENTS.md after install/remove
- registryUrl - Custom registry URL
- cacheEnabled - Enable registry caching
- cacheTTL - Cache time-to-live in hours
š Web Interface
Browse skills through a beautiful web interface:
`bash
npx ralphy-skills serve
``