@claude-collective/cli 0.1.0 → 0.1.3

package/CHANGELOG.md

@@ -5,6 +5,37 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.1.3] - 2026-01-30
+
+### Added
+
+- `--output` option for eject command to specify custom output directory
+- Remote schema fetching for skill validation from GitHub
+
+### Fixed
+
+- Plugin manifest no longer includes agents field (Claude Code discovers automatically)
+- Source loader now supports source-provided skills matrix
+
+[0.1.3]: https://github.com/claude-collective/cli/releases/tag/v0.1.3
+
+## [0.1.2] - 2026-01-30
+
+### Changed
+
+- Removed local dev files from repo (.claude, CLAUDE.md)
+
+[0.1.2]: https://github.com/claude-collective/cli/releases/tag/v0.1.2
+
+## [0.1.1] - 2026-01-30
+
+### Fixed
+
+- `GITHUB_REPO` const now points to correct repo
+- README agent names match actual stack config
+
+[0.1.1]: https://github.com/claude-collective/cli/releases/tag/v0.1.1
+
 ## [0.1.0] - 2026-01-30
 
 ### Added

package/README.md

@@ -1,278 +1,113 @@
 # Claude Collective CLI
 
-> Make Claude Code an expert in your tech stack. Production-ready knowledge modules for React, Hono, Drizzle, and 80+ more.
-
-[![npm version](https://img.shields.io/npm/v/@claude-collective/cli.svg)](https://www.npmjs.com/package/@claude-collective/cli)
-[![npm downloads](https://img.shields.io/npm/dm/@claude-collective/cli.svg)](https://www.npmjs.com/package/@claude-collective/cli)
-[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
-
-**Stop teaching Claude your conventions. Start coding.**
+the CLI for working with Claude Collective skills. it's the entry point for everything: installing skills, creating stacks, and creating custom skills and subagents
 
 ```bash
 npx @claude-collective/cli init
 ```
 
-## What is this?
+## what this does
 
-[Claude Code](https://docs.anthropic.com/en/docs/claude-code) is Anthropic's agentic coding CLI. Out of the box, Claude knows programming - but not _your_ patterns, _your_ libraries, _your_ conventions.
+Claude Code is okay out of the box, but it doesn't know your stack. the skills repository has 80+ in-depth modules covering react, hono, drizzle, posthog, and a lot more. each skill is atomic, comprehensive, and composable into agents and stacks
 
-**Claude Collective fixes that.** We provide **skills** - focused knowledge modules that make Claude an expert in specific technologies:
+the CLI is how you work with all of it:
 
-| Term       | What it is                                                                   |
-| ---------- | ---------------------------------------------------------------------------- |
-| **Skills** | Expertise in one technology (React 19, Hono v4, Drizzle ORM, etc.)           |
-| **Stacks** | Curated bundles for common setups ("nextjs-fullstack" = React + Hono + auth) |
-| **Agents** | Specialized roles (frontend-developer, backend-reviewer, etc.)               |
+- **install skills** as plugins or locally into your project
+- **create stacks** by bundling skills with a modular agent approach
+- **scaffold new skills** when you need something custom
+- **set up your own marketplace** if you're building for a team or org
 
-## Installation
+## getting started
 
 ```bash
-# Recommended: Use npx (no install required)
+# run the wizard - picks skills, sets up agents
 npx @claude-collective/cli init
 
-# Or install globally
+# or install globally
 npm install -g @claude-collective/cli
-yarn global add @claude-collective/cli
-pnpm add -g @claude-collective/cli
-bun add -g @claude-collective/cli
 ```
 
-Requires Node.js 18+ and [Claude Code](https://docs.anthropic.com/en/docs/claude-code) installed.
+requires node 18+ and [Claude Code](https://docs.anthropic.com/en/docs/claude-code).
 
-## Quick Start (60 seconds)
+## commands
 
 ```bash
-# 1. Run the wizard in your project
-cd your-project
-npx @claude-collective/cli init
-
-# 2. Select a stack (or pick individual skills)
-#    ? What type of project? > Fullstack React
-#    ? Include agents? > Yes
-
-# 3. Done! Skills installed to .claude/skills/
+cc init          # interactive setup - pick skills, configure agents
+cc edit          # modify your skill selection
+cc compile       # recompile agents after changes
+cc list          # show what's installed
+cc config        # manage settings
+cc validate      # check your setup is correct
 ```
 
-**Or skip the wizard:**
-
-```bash
-# Initialize with a specific stack directly
-cc init --stack nextjs-fullstack
-```
+## how skills work
 
-## See It In Action
+a skill is focused knowledge for one technology. not surface-level docs but actual patterns, edge cases, the things you'd normally have to explain repeatedly
 
-**Before skills:** Claude gives generic React advice.
+skills live in the [claude-collective/skills](https://github.com/claude-collective/skills) repository, organized by category:
 
-**After installing `react` skill:** Claude knows:
+| category | what's there                                                                        |
+| -------- | ----------------------------------------------------------------------------------- |
+| web      | react 19, next.js, remix, vue, angular, solidjs, scss-modules, zustand, react-query |
+| api      | hono, drizzle, better-auth, posthog, resend, axiom+pino+sentry                      |
+| mobile   | react-native, expo                                                                  |
+| cli      | commander.js, clack prompts                                                         |
+| infra    | turborepo, github-actions, env config                                               |
+| security | auth patterns, xss prevention, secrets                                              |
+| meta     | code reviewing, research methodology                                                |
 
-- Your project uses React 19 with the new `use` hook
-- Error boundaries should use `react-error-boundary`
-- Components go in `kebab-case.tsx` files with named exports
-- State management follows your Zustand patterns
+## stacks
 
-**What skills teach Claude:**
+stacks bundle skills together with pre-configured agents. instead of picking 20 skills individually, grab a stack that matches your setup:
 
-| Skill     | Claude Learns                                              |
-| --------- | ---------------------------------------------------------- |
-| `react`   | React 19 patterns, hooks, error boundaries, file structure |
-| `hono`    | Route handlers, middleware, OpenAPI integration, Zod       |
-| `drizzle` | Schema patterns, migrations, transactions, relations       |
-| `vitest`  | Test patterns, mocking, coverage requirements              |
+- **nextjs-fullstack** - next.js app router + hono + drizzle + posthog
+- **react-native-stack** - react native with expo
+- **vue-stack** - vue 3 + nuxt
+- **angular-stack** - angular 17+ standalone
+- **remix-stack** - remix with loaders/actions
+- **solidjs-stack** - solidjs fine-grained reactivity
+- **nuxt-stack** - nuxt 3 with nitro
 
-## Commands
+each stack includes agents like `web-developer`, `api-reviewer`, `web-tester` - roles that use the right skills for the job.
 
-### Essential Commands
+## installation options
 
-| Command                  | Description                           |
-| ------------------------ | ------------------------------------- |
-| `cc init`                | Interactive setup wizard - start here |
-| `cc init --stack <name>` | Skip wizard, use a predefined stack   |
-| `cc list`                | Browse available skills and stacks    |
-| `cc list --installed`    | See what's currently installed        |
-
-### Advanced Commands
-
-| Command       | Description                                 |
-| ------------- | ------------------------------------------- |
-| `cc compile`  | Compile agent templates (for custom agents) |
-| `cc validate` | Check skill files for errors                |
-| `cc config`   | View or edit `.claude/config.yaml`          |
-| `cc eject`    | Export templates for customization          |
-
-Run `cc --help` for full usage details.
-
-## Available Stacks
-
-| Stack                | Includes                                                | Best For                   |
-| -------------------- | ------------------------------------------------------- | -------------------------- |
-| `nextjs-fullstack`   | Next.js App Router, Hono, Drizzle, Better Auth, Zustand | Full-stack TypeScript apps |
-| `angular-stack`      | Angular 19, Signals, NgRx SignalStore, Hono, Drizzle    | Enterprise Angular apps    |
-| `vue-stack`          | Vue 3 Composition API, Pinia, Tailwind, Hono, Drizzle   | Vue.js applications        |
-| `nuxt-stack`         | Nuxt 3, Vue 3, Pinia, Tailwind, Hono, Drizzle           | Full-stack Vue apps        |
-| `remix-stack`        | Remix, React, Tailwind, Zustand, Hono, Drizzle          | Form-heavy applications    |
-| `solidjs-stack`      | SolidJS, Tailwind, Vitest, Hono, Drizzle                | High-performance apps      |
-| `react-native-stack` | React Native, Expo, Zustand, React Query                | Cross-platform mobile      |
+**as a plugin** (recommended for personal use):
 
 ```bash
-# See all stacks
-cc list --stacks
+cc init
+# installs to ~/.claude/plugins/claude-collective/
 ```
 
-## Available Skills
-
-80+ skills across domains:
-
-- **Web**: React, SCSS Modules, Zustand, React Query, MSW
-- **API**: Hono, Drizzle, Better Auth, Resend, PostHog
-- **Infra**: GitHub Actions, Turborepo, monitoring, CI/CD
-- **Quality**: Vitest, Security, Accessibility, Testing patterns
+**locally in your project** (for team sharing):
 
 ```bash
-# Browse all available skills
-cc list --skills
-```
-
-## How It Works
-
-1. **Install skills** via `cc init` or manually to `.claude/skills/`
-2. **Skills are loaded** automatically by Claude Code
-3. **Agents use skills** to provide expert-level assistance
-
-```
-.claude/
-├── skills/           # Installed skills
-│   ├── react/
-│   ├── hono/
-│   └── drizzle/
-└── agents/           # Compiled agents (optional)
-    ├── frontend-developer.md
-    └── backend-developer.md
-```
-
-## Configuration
-
-Configuration is stored in `.claude/config.yaml`:
-
-```yaml
-stack: nextjs-fullstack
-skills:
-  - react
-  - hono
-  - drizzle
-```
-
-Edit manually or use `cc config`.
-
-## Creating Custom Skills
-
-Skills are markdown files with YAML frontmatter:
-
+cc init --local
+# installs to ./.claude/ in your repo
 ```
-.claude/skills/my-skill/
-├── SKILL.md          # Main skill file (required)
-├── metadata.yaml     # Skill metadata (optional)
-└── examples/         # Code examples (optional)
-    └── core.md
-```
-
-**SKILL.md template:**
-
-```markdown
----
-name: my-custom-skill
-description: Brief description for Claude
-globs: ["src/**/*.ts"]
----
-
-# My Custom Skill
-
-## When to Use
-
-[Describe when Claude should apply this knowledge]
-
-## Patterns
-
-[Explain patterns with code examples]
-
-## Anti-Patterns
-
-[What NOT to do]
-```
-
-**Tips:**
-
-- Be specific: "Use `date-fns`" not "use a date library"
-- Include anti-patterns: Tell Claude what to avoid
-- Add real examples: Code from your actual codebase works best
-
-## Troubleshooting
-
-<details>
-<summary><strong>Skills not loading in Claude Code?</strong></summary>
 
-1. Ensure skills are in `.claude/skills/` (not `.claude-skills/`)
-2. Each skill needs a `SKILL.md` file
-3. Restart Claude Code after adding skills
-4. Run `cc validate` to check for errors
-
-</details>
-
-<details>
-<summary><strong>Permission denied on global install?</strong></summary>
-
-Use a Node version manager (nvm, fnm) or install to user directory:
+**your own marketplace** (for orgs):
 
 ```bash
-npm install -g @claude-collective/cli --prefix ~/.npm-global
+cc init --marketplace
+# scaffolds a marketplace you can customize and host
 ```
 
-</details>
-
-<details>
-<summary><strong>"cc" command not found after install?</strong></summary>
+## creating custom skills
 
-Your global npm bin directory may not be in PATH. Try:
+if the existing skills don't cover what you need:
 
 ```bash
-# Find where npm installs global bins
-npm config get prefix
-
-# Add to PATH (add to ~/.bashrc or ~/.zshrc)
-export PATH="$(npm config get prefix)/bin:$PATH"
+cc new skill my-custom-skill
 ```
 
-Or use `npx @claude-collective/cli` instead.
-
-</details>
-
-## FAQ
-
-**Q: Does this work with Claude Code Pro/Team?**
-A: Yes, skills work with any Claude Code installation.
-
-**Q: Can I use custom skills alongside collective skills?**
-A: Yes! Add custom skills to `.claude/skills/my-skill/SKILL.md`.
-
-**Q: How do I update skills?**
-A: Re-run `cc init` or manually update files in `.claude/skills/`.
-
-## Requirements
-
-- **Node.js** 18.0.0 or higher
-- **Claude Code** installed and configured
-
-## Links
-
-- [Claude Code Documentation](https://docs.anthropic.com/en/docs/claude-code)
-- [Skills Repository](https://github.com/claude-collective/skills)
-- [Issue Tracker](https://github.com/claude-collective/cli/issues)
-- [Changelog](CHANGELOG.md)
+this scaffolds the structure. a skill is just markdown with examples - no special tooling required.
 
-## Contributing
+## links
 
-We welcome contributions! Please open an issue or PR on GitHub.
+- [skills repository](https://github.com/claude-collective/skills) - all the skills and stacks
+- [Claude Code docs](https://docs.anthropic.com/en/docs/claude-code) - the tool this extends
 
-## License
+## license
 
-MIT - see [LICENSE](LICENSE) for details.
+MIT