cokit-cli 1.0.0

package/FAQ.md

@@ -0,0 +1,102 @@
+# FAQ
+
+## Installation
+
+### What's the difference between repo and global?
+
+| Type | Location | Scope | Share with Team |
+|------|----------|-------|-----------------|
+| Repo | `.github/` | This project only | Yes (via git) |
+| Global | `~/.copilot/skills/` | All your projects | No |
+
+### Do I need to edit any files?
+
+No. Just run `npx cokit init` and you're done.
+
+### Can I customize the prompts?
+
+Yes! Edit any `.prompt.md` file in `.github/prompts/`.
+
+### Does this work with JetBrains IDEs?
+
+- **Prompts**: Yes
+- **Skills**: Partial support (check JetBrains docs)
+
+## Usage
+
+### How do I use a prompt?
+
+Type the prompt name in Copilot Chat:
+```
+/fix my login function throws an error
+```
+
+### Why isn't Copilot responding to my prompts?
+
+1. Restart VS Code after installing
+2. Make sure Copilot extension is active
+3. Run `npx cokit doctor` to check setup
+
+### Can I add my own prompts?
+
+Yes! Create a file like `.github/prompts/my-prompt.prompt.md`:
+```yaml
+---
+mode: agent
+description: What this prompt does
+---
+Your instructions here...
+```
+
+## Technical
+
+### What files does CoKit create?
+
+**Repo-level (`.github/`):**
+- `copilot-instructions.md` - Project rules
+- `AGENTS.md` - Agent behavior
+- `prompts/*.prompt.md` - 6 prompt files
+- `skills/*/SKILL.md` - 2 skill files
+- `instructions/*.instructions.md` - 4 instruction files
+
+**User-level (`~/.copilot/skills/`):**
+- 5 skill directories with SKILL.md + references
+
+### Does CoKit modify my code?
+
+No. It only creates configuration files for Copilot.
+
+### How do I uninstall?
+
+Delete the files:
+```bash
+rm -rf .github/prompts .github/skills .github/instructions
+rm .github/copilot-instructions.md .github/AGENTS.md
+```
+
+For global:
+```bash
+rm -rf ~/.copilot/skills
+```
+
+## Troubleshooting
+
+### "Permission denied" error
+
+Use sudo (macOS/Linux) or run as admin (Windows):
+```bash
+sudo npx cokit init --global
+```
+
+### "Node.js not found"
+
+Install Node.js 18+ from https://nodejs.org
+
+### Skills not working
+
+Enable in VS Code settings:
+```json
+{
+  "github.copilot.chat.useAgentSkills": true
+}
+```

package/LICENSE

@@ -0,0 +1,32 @@
+Creative Commons Attribution-NonCommercial 4.0 International License (CC BY-NC 4.0)
+
+Copyright (c) 2026 camping89
+
+This work is licensed under the Creative Commons Attribution-NonCommercial 4.0 
+International License.
+
+You are free to:
+- Share: copy and redistribute the material in any medium or format
+- Adapt: remix, transform, and build upon the material
+
+Under the following terms:
+- Attribution: You must give appropriate credit, provide a link to the license, 
+  and indicate if changes were made.
+- NonCommercial: You may not use the material for commercial purposes.
+  This includes use by companies, corporations, or for-profit organizations.
+
+No additional restrictions: You may not apply legal terms or technological 
+measures that legally restrict others from doing anything the license permits.
+
+PERMITTED USES:
+- Personal projects
+- Educational purposes
+- Academic research
+- Non-profit organizations
+
+PROHIBITED USES:
+- Commercial products or services
+- Corporate/company internal use
+- Revenue-generating applications
+
+Full license text: https://creativecommons.org/licenses/by-nc/4.0/legalcode

package/QUICK-START.md

@@ -0,0 +1,37 @@
+# 30-Second Setup
+
+## Step 1: Install
+
+```bash
+npx cokit init
+```
+
+## Step 2: Open VS Code
+
+Open your project in VS Code.
+
+## Step 3: Try It
+
+Type `/fix` in Copilot Chat.
+
+## Done!
+
+You now have 6 prompts and 5 skills ready to use.
+
+---
+
+## What's Next?
+
+Try these prompts in Copilot Chat:
+
+- `/fix` - Got a bug? Copilot will debug it
+- `/plan` - Need a feature? Copilot will plan it
+- `/review` - Ready to commit? Copilot will review it
+
+## Need Help?
+
+```bash
+npx cokit doctor
+```
+
+This checks your setup and suggests fixes.

package/README.md

@@ -0,0 +1,110 @@
+# CoKit
+
+Make GitHub Copilot smarter in 30 seconds.
+
+[![npm version](https://img.shields.io/npm/v/cokit.svg)](https://www.npmjs.com/package/cokit)
+[![License: CC BY-NC 4.0](https://img.shields.io/badge/License-CC%20BY--NC%204.0-lightgrey.svg)](https://creativecommons.org/licenses/by-nc/4.0/)
+
+## Quick Start
+
+```bash
+npx cokit init
+```
+
+That's it! Now open VS Code and try `/fix` in Copilot Chat.
+
+## What You Get
+
+### Prompts (type in Copilot Chat)
+
+| Command | What it does |
+|---------|--------------|
+| `/fix` | Debug and fix code issues |
+| `/plan` | Create implementation plans |
+| `/review` | Review code before committing |
+| `/test` | Write tests for your code |
+| `/code` | Implement from a plan |
+| `/docs` | Update documentation |
+
+### Skills (automatic)
+
+CoKit teaches Copilot how to:
+- Debug systematically (not randomly)
+- Review code like a senior dev
+- Plan before coding
+- Find documentation efficiently
+- Think through complex problems
+
+## Installation Options
+
+### Option 1: Project Only (Recommended)
+
+```bash
+npx cokit init
+```
+
+Creates files in `.github/` - share with your team via git.
+
+### Option 2: Personal Skills
+
+```bash
+npx cokit init --global
+```
+
+Creates files in `~/.copilot/skills/` - works in all projects.
+
+### Option 3: Both
+
+```bash
+npx cokit init --all
+```
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `cokit init` | Set up CoKit in your project |
+| `cokit add <skill>` | Add a specific skill |
+| `cokit list` | Show available skills and prompts |
+| `cokit doctor` | Check your setup |
+| `cokit update` | Update to latest version |
+
+## Troubleshooting
+
+Run the doctor:
+
+```bash
+npx cokit doctor
+```
+
+### Common Issues
+
+**"Copilot doesn't see my prompts"**
+- Restart VS Code after running `npx cokit init`
+
+**"Skills not working"**
+- Enable in VS Code: Settings → `github.copilot.chat.useAgentSkills`
+
+**"Command not found"**
+- Make sure you have Node.js 18+ installed
+
+## For Claude Code Users
+
+Migrating from Claude Code? See [Migration Guide](docs/migration-guide.md).
+
+Key differences:
+- No hooks (static config only)
+- No subagents (single Copilot agent)
+- No `$ARGUMENTS` (user provides context in chat)
+
+## Documentation
+
+- [Quick Start](QUICK-START.md) - 30-second setup
+- [FAQ](FAQ.md) - Common questions
+- [Migration Guide](docs/migration-guide.md) - For Claude Code users
+
+## License
+
+CC BY-NC 4.0 - Free for personal and educational use.
+
+Commercial use requires a license. Contact for details.

package/bin/cokit.js

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+
+// CLI entry point - delegates to main module
+import '../src/index.js';