magicpath-ai 1.3.0-beta.2 → 1.3.0-beta.4

package/skills/magicpath-add-component/SKILL.md

@@ -0,0 +1,49 @@
+# MagicPath Add Component
+
+Add a MagicPath component to the current project.
+
+## Prerequisites
+
+- Must be in a directory with `package.json`
+- Must be authenticated (see `magicpath-shared` skill)
+
+## Usage
+
+```bash
+# Preview what will be added
+magicpath-ai add <generatedName> --output json --yes --dry-run
+
+# Actually add the component
+magicpath-ai add <generatedName> --output json --yes
+```
+
+## Parameters
+
+| Parameter | Required | Description |
+|-----------|----------|-------------|
+| `generatedName` | Yes | Component identifier (e.g., `wispy-river-5234`) |
+| `--yes` | Recommended | Skip confirmation prompts |
+| `--overwrite` | No | Overwrite existing files |
+| `--path <path>` | No | Custom component path (default: `src/components/magicpath`) |
+| `--dry-run` | No | Preview without writing files |
+
+## Output (JSON)
+
+```json
+{
+  "component": "ComponentName",
+  "generatedName": "wispy-river-5234",
+  "filesWritten": ["src/components/magicpath/component-name/Component.tsx"],
+  "dependenciesInstalled": ["lucide-react"],
+  "importStatement": "import { Component } from '@/components/magicpath/component-name/Component';",
+  "usage": "<Component />",
+  "dryRun": false
+}
+```
+
+## Workflow
+
+1. Run `magicpath-ai list-projects --output json` to find your project
+2. Run `magicpath-ai list-components <projectId> --output json` to find the component's `generatedName`
+3. Run `magicpath-ai add <generatedName> --output json --yes` to install it
+4. Use the returned `importStatement` in your code

package/skills/magicpath-integrate/SKILL.md

@@ -0,0 +1,50 @@
+# MagicPath Integrate
+
+Use AI to integrate a MagicPath component into a specific file in your project.
+
+## Prerequisites
+
+- Must be in a directory with `package.json`
+- Must be authenticated (see `magicpath-shared` skill)
+
+## Usage
+
+```bash
+# Preview what will change
+magicpath-ai integrate <generatedName> --target <file> --output json --dry-run
+
+# Actually integrate
+magicpath-ai integrate <generatedName> --target <file> --no-review --output json
+```
+
+## Parameters
+
+| Parameter | Required | Description |
+|-----------|----------|-------------|
+| `generatedName` | Yes | Component identifier (e.g., `wispy-river-5234`) |
+| `--target <file>` | Yes (in JSON mode) | File to integrate into (e.g., `src/app/page.tsx`) |
+| `--no-review` | Recommended | Skip interactive review |
+| `--dry-run` | No | Preview without writing files |
+
+## Output (JSON)
+
+The command returns modified file contents **without writing to disk**. The agent is responsible for applying the changes.
+
+```json
+{
+  "modifiedFiles": [
+    {
+      "path": "src/app/page.tsx",
+      "content": "// full file content after integration..."
+    }
+  ],
+  "framework": "nextjs-app"
+}
+```
+
+To apply, write each `modifiedFiles[].content` to its `path`.
+
+## Workflow
+
+1. First add the component: `magicpath-ai add <generatedName> --output json --yes`
+2. Then integrate it: `magicpath-ai integrate <generatedName> --target src/app/page.tsx --no-review --output json`

package/skills/magicpath-list/SKILL.md

@@ -0,0 +1,38 @@
+# MagicPath List
+
+Discover projects and components available in your MagicPath account.
+
+## Prerequisites
+
+- Must be authenticated (see `magicpath-shared` skill)
+
+## Commands
+
+### Check authentication
+
+```bash
+magicpath-ai whoami --output json
+```
+
+### List projects
+
+```bash
+magicpath-ai list-projects --output json
+```
+
+Returns an array of projects with `id`, `name`, and `componentCount`.
+
+### List components in a project
+
+```bash
+magicpath-ai list-components <projectId> --output json
+```
+
+Returns an array of components with `id`, `name`, and `generatedName`.
+
+## Workflow
+
+1. `magicpath-ai whoami --output json` — verify authentication
+2. `magicpath-ai list-projects --output json` — find the project ID
+3. `magicpath-ai list-components <projectId> --output json` — find the `generatedName` for the component you want to use
+4. Use the `generatedName` with `add` or `integrate` commands

package/skills/magicpath-shared/SKILL.md

@@ -0,0 +1,34 @@
+# MagicPath Shared Setup
+
+## Install
+
+```bash
+npm install -g magicpath-ai
+```
+
+## Authentication
+
+Set the `MAGICPATH_TOKEN` environment variable with your API token:
+
+```bash
+export MAGICPATH_TOKEN="your-jwt-token-here"
+```
+
+Or authenticate interactively:
+
+```bash
+magicpath-ai login
+```
+
+## Verify
+
+```bash
+magicpath-ai whoami --output json
+```
+
+## Notes
+
+- All commands support `--output json` for structured output
+- Use `MAGICPATH_TOKEN` env var for non-interactive/CI auth
+- Use `--dry-run` on `add` and `integrate` to preview changes
+- Use `magicpath-ai schema --all` to see input/output schemas for all commands