skillstogether 0.1.0

package/README.md

@@ -0,0 +1,294 @@
+# skillstogether
+
+CLI tool to install organization skills from SkillsTogether.
+
+```
+███████╗██╗  ██╗██╗██╗     ██╗     ███████╗████████╗ ██████╗  ██████╗ ███████╗████████╗██╗  ██╗███████╗██████╗
+██╔════╝██║ ██╔╝██║██║     ██║     ██╔════╝╚══██╔══╝██╔═══██╗██╔════╝ ██╔════╝╚══██╔══╝██║  ██║██╔════╝██╔══██╗
+███████╗█████╔╝ ██║██║     ██║     ███████╗   ██║   ██║   ██║██║  ███╗█████╗     ██║   ███████║█████╗  ██████╔╝
+╚════██║██╔═██╗ ██║██║     ██║     ╚════██║   ██║   ██║   ██║██║   ██║██╔══╝     ██║   ██╔══██║██╔══╝  ██╔══██╗
+███████║██║  ██╗██║███████╗███████╗███████║   ██║   ╚██████╔╝╚██████╔╝███████╗   ██║   ██║  ██║███████╗██║  ██║
+╚══════╝╚═╝  ╚═╝╚═╝╚══════╝╚══════╝╚══════╝   ╚═╝    ╚═════╝  ╚═════╝ ╚══════╝   ╚═╝   ╚═╝  ╚═╝╚══════╝╚═╝  ╚═╝
+```
+
+## Installation
+
+```bash
+# Use directly with npx (recommended)
+npx skillstogether add <organization-slug>
+
+# Or install globally
+npm install -g skillstogether
+```
+
+## Usage
+
+### Authentication
+
+```bash
+# Log in via browser
+npx skillstogether auth login
+
+# Check authentication status
+npx skillstogether auth status
+
+# Log out
+npx skillstogether auth logout
+```
+
+### Installing Skills
+
+```bash
+# Install skills interactively (select which skills to install)
+npx skillstogether add <organization-slug>
+
+# Install all skills without prompts
+npx skillstogether add <organization-slug> -y
+
+# Install a specific skill
+npx skillstogether add <organization-slug>/<skill-slug>
+# or
+npx skillstogether add <organization-slug> --skill <skill-slug>
+
+# Install globally (in home directory)
+npx skillstogether add <organization-slug> --global
+
+# Overwrite existing skill files
+npx skillstogether add <organization-slug> --force
+
+# Custom installation directory
+npx skillstogether add <organization-slug> --dir ./my-skills
+```
+
+### Options
+
+| Option              | Alias | Description                                |
+| ------------------- | ----- | ------------------------------------------ |
+| `--dir <path>`      | `-d`  | Custom installation directory              |
+| `--force`           | `-f`  | Overwrite existing skill files             |
+| `--yes`             | `-y`  | Skip interactive prompts, install all      |
+| `--skill <slug>`    | —     | Install a specific skill by slug           |
+| `--global`          | —     | Install globally (in home directory)       |
+
+---
+
+## Telemetry
+
+The CLI collects telemetry data to help improve skills and track usage. This data includes:
+
+- Skill name and slug
+- Organization slug
+- Target agent (e.g., Cursor, Claude Code)
+- Installation scope (project or global)
+- Timestamp
+
+**No personal or device information is collected.**
+
+---
+
+## Development
+
+### Prerequisites
+
+- Node.js >= 18
+- pnpm
+
+### Setup
+
+```bash
+# From the monorepo root
+pnpm install
+
+# Navigate to CLI package
+cd packages/cli
+```
+
+### Build
+
+```bash
+# Build the CLI
+pnpm build
+
+# Watch mode (rebuild on changes)
+pnpm dev
+```
+
+### Running Locally
+
+#### Option 1: Run directly with Node
+
+```bash
+# From packages/cli directory
+node dist/index.js --help
+node dist/index.js auth login
+node dist/index.js add my-org
+```
+
+#### Option 2: Link globally
+
+```bash
+# From packages/cli directory
+pnpm link --global
+
+# Now use it anywhere
+skillstogether --help
+skillstogether auth login
+
+# To unlink
+pnpm unlink --global
+```
+
+#### Option 3: Run from monorepo root
+
+```bash
+# From monorepo root
+node packages/cli/dist/index.js --help
+```
+
+### Environment Variables
+
+| Variable              | Default                 | Description          |
+| --------------------- | ----------------------- | -------------------- |
+| `CLI_API_URL`  | `http://localhost:3000` | API server URL       |
+
+Example:
+
+```bash
+# Use a different API URL
+CLI_API_URL=http://localhost:3000 node dist/index.js auth login
+```
+
+### Testing the Full Flow
+
+1. Start the Next.js dev server:
+   ```bash
+   # From monorepo root
+   pnpm dev
+   ```
+
+2. In another terminal, build and run the CLI:
+   ```bash
+   cd packages/cli
+   pnpm build
+   node dist/index.js auth login
+   node dist/index.js add <your-org-slug>
+   ```
+
+### Type Checking
+
+```bash
+pnpm typecheck
+```
+
+---
+
+## Publishing to npm
+
+### Prerequisites
+
+1. You need an npm account with publish access to the `@skillstogether` scope
+2. Log in to npm:
+   ```bash
+   npm login
+   ```
+
+### Publishing Steps
+
+#### 1. Update the version
+
+```bash
+# Patch release (0.1.0 -> 0.1.1)
+npm version patch
+
+# Minor release (0.1.0 -> 0.2.0)
+npm version minor
+
+# Major release (0.1.0 -> 1.0.0)
+npm version major
+```
+
+#### 2. Build and publish
+
+```bash
+# Build the package (runs automatically via prepublishOnly)
+pnpm build
+
+# Publish to npm
+pnpm publish --access public
+```
+
+Or as a single command:
+
+```bash
+npm version patch && pnpm publish --access public
+```
+
+#### 3. Verify the publish
+
+```bash
+# Check the package on npm
+npm view skillstogether
+
+# Test with npx
+npx skillstogether@latest --help
+```
+
+### Publishing Checklist
+
+- [ ] Update version in `package.json`
+- [ ] Ensure all changes are committed
+- [ ] Build passes (`pnpm build`)
+- [ ] Type check passes (`pnpm typecheck`)
+- [ ] Test locally before publishing
+- [ ] Publish with `pnpm publish --access public`
+- [ ] Create a git tag for the release
+
+### Creating a Release Tag
+
+```bash
+# After publishing, create a git tag
+git tag cli-v0.1.0
+git push origin cli-v0.1.0
+```
+
+---
+
+## Project Structure
+
+```
+packages/cli/
+├── src/
+│   ├── index.ts          # Entry point, CLI setup
+│   ├── commands/
+│   │   ├── add.ts        # Install skills command
+│   │   └── auth.ts       # Authentication commands
+│   ├── lib/
+│   │   ├── api.ts        # API client
+│   │   ├── config.ts     # Config file management
+│   │   └── installer.ts  # Skill file installation
+│   └── utils/
+│       ├── banner.ts     # ASCII art banner
+│       └── browser.ts    # Browser auth flow
+├── dist/                 # Built output
+├── package.json
+├── tsconfig.json
+└── README.md
+```
+
+---
+
+## Configuration
+
+The CLI stores configuration in `~/.skillstogether/config.json`:
+
+```json
+{
+  "token": "your-auth-token"
+}
+```
+
+---
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1 @@
+#!/usr/bin/env node