https://github.com/ctxr-dev/skills
https://github.com/ctxr-dev/skills
Last synced: about 1 month ago
JSON representation
- Host: GitHub
- URL: https://github.com/ctxr-dev/skills
- Owner: ctxr-dev
- Created: 2026-04-11T13:30:55.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2026-04-11T14:01:16.000Z (3 months ago)
- Last Synced: 2026-04-11T14:07:51.706Z (3 months ago)
- Language: JavaScript
- Size: 0 Bytes
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# @ctxr-dev/skills
[](https://www.npmjs.com/package/@ctxr-dev/skills)
[](LICENSE)
CLI for managing Claude Code skills — install, validate, update, and scaffold.
## Install
```bash
npm install -g @ctxr-dev/skills
# or use with npx
npx @ctxr-dev/skills
```
## Commands
### `skills install [options]`
Install a skill. Supports npm packages, GitHub repos, and local paths.
```bash
skills install @ctxr-dev/skill-code-review # from npm → .claude/skills/
skills install @ctxr-dev/skill-code-review -i # interactive: choose location
skills install @ctxr-dev/skill-code-review --global # → ~/.claude/skills/ (shared)
skills install @ctxr-dev/skill-code-review --dir .agents/skills # explicit directory
skills install github:ctxr-dev/skill-code-review # from GitHub
skills install ./path/to/local-skill # from local path
```
Install locations:
- `.claude/skills/` — project-level, Claude Code default
- `.agents/skills/` — project-level, open standard
- `~/.claude/skills/` — user-global, shared across projects
- Custom path via `--dir`
Auto-detects: if `.agents/skills/` exists, installs there. Otherwise `.claude/skills/`.
### `skills validate [path]`
Validate a skill's structure and integrity.
```bash
skills validate # validate skill in current dir
skills validate ./my-skill # validate skill at path
```
### `skills update [skill] [project-path]`
Update installed skill(s). Searches all locations (`.claude/skills/`, `.agents/skills/`, `~/.claude/skills/`), finds where each skill lives, updates it in place.
```bash
skills update # update all installed skills
skills update skill-code-review # update specific skill
```
### `skills list [project-path]`
List skills from all discovered locations.
```bash
skills list # current project + global
skills list ./my-project # specific project + global
```
### `skills init [name]`
Scaffold a new skill project.
```bash
skills init my-new-skill
```
### `skills info `
Show info about a skill from local install or npm registry. Searches all locations.
```bash
skills info @ctxr-dev/skill-code-review
skills info skill-code-review
```
## Publishing
### First-time setup
1. Create an npm access token: `npm token create`
2. In GitHub repo: **Settings → Secrets → Actions** → add `NPM_TOKEN`
### Release
1. **Actions → Release → Run workflow** → choose patch/minor/major
2. Workflow bumps version, tags, pushes → triggers Publish workflow
## Development
```bash
npm install
npm test # run all tests
npm run test:unit # unit tests only
npm run test:integration # integration tests only
```
Pre-commit hook runs `npm test` automatically.
## License
[MIT](LICENSE)