@brookmind/ai-toolkit 1.0.5 → 1.1.2

package/README.md

@@ -1,6 +1,6 @@
-# CKW AI Toolkit
+# AI Toolkit
 
-A collection of agents, skills, and MCPs for Claude Code and OpenCode.
+A collection of agents, skills, and MCPs for AI coding assistants.
 
 ## Quick Install
 
@@ -8,30 +8,42 @@ A collection of agents, skills, and MCPs for Claude Code and OpenCode.
 npx @brookmind/ai-toolkit
 ```
 
-The interactive installer will guide you through selecting:
-- **Platform**: Claude Code, OpenCode, or Both
-- **Agents**: AI assistants for specific tasks
-- **Skills**: Extended capabilities and workflows
-- **MCPs**: Model Context Protocol servers
+The installer will:
+
+1. **Check if OpenCode is installed** - If not, it will offer to install it for you
+2. **Guide you through selecting**:
+   - **Agents**: AI assistants for specific tasks
+   - **Skills**: Extended capabilities and workflows
+   - **MCPs**: Model Context Protocol servers
+3. **Theme installation**:
+   - **New installations**: claude-vivid theme is installed automatically
+   - **Existing installations**: You'll be asked if you want to install the theme
 
 ## What's Included
 
 ### Agents
+
 - `code-reviewer` - Expert code review for quality and security
+- `code-simplifier` - Simplifies and refines code for clarity and maintainability
 
 ### Skills
-- `cloudflare-cli` - Cloudflare Workers, KV, D1, R2 operations
+
 - `github-cli` - GitHub operations (issues, PRs, releases)
-- `docx` - Word document manipulation
-- `pdf` - PDF processing and forms
-- `xlsx` - Spreadsheet operations
+- `pdf-processing-pro` - Advanced PDF processing (OCR, tables, forms extraction)
+- `react-best-practices` - React performance optimization guidelines from Vercel Engineering
 - `skill-creator` - Create new skills
 
 ### MCPs
+
 - `context7` - Up-to-date library documentation
 - `expo-mcp` - Expo/React Native utilities
-- `figma-mcp` - Figma design integration
-- `pg-aiguide` - PostgreSQL assistance
+- `figma-mcp` - Figma design integration (requires Figma Desktop app)
+
+### Theme
+
+- `claude-vivid` - High-contrast theme with vivid colors inspired by Claude Code
+  - Auto-installed for new OpenCode users
+  - Optional for existing OpenCode users
 
 ## Manual Installation
 
@@ -47,7 +59,41 @@ npm start
 ## Requirements
 
 - Node.js 18+
-- Claude Code and/or OpenCode installed
+- OpenCode installed
+- For Figma MCP: Figma Desktop app running
+
+## Configuration
+
+After installation, some MCPs require API keys. Edit `~/.config/opencode/opencode.json` and replace `TOKEN_PLACEHOLDER` with your actual keys:
+
+- **context7**: Get your API key at https://context7.com
+- **expo-mcp**: Get your API key at https://expo.dev
+
+## Connecting GitHub Copilot
+
+To use GitHub Copilot with OpenCode, follow these steps:
+
+1. **Run the connect command** in OpenCode:
+
+   ```
+   /connect
+   ```
+
+   ![Step 1: Run /connect command](docs/images/github-copilot-step1.png)
+
+2. **Select GitHub Copilot** from the list of providers:
+
+   ![Step 2: Select GitHub Copilot](docs/images/github-copilot-step2.png)
+
+3. **Copy the code and open the URL**: OpenCode will display a URL (`https://github.com/login/device`) and a code. Open the URL in your browser.
+
+   ![Step 3: Get authorization URL and code](docs/images/github-copilot-step3.png)
+
+4. **Complete authorization**: On the GitHub Device Activation page, verify your account and click the green "Continue" button to authorize OpenCode to use your GitHub Copilot license.
+
+   ![Step 4: Authorize on GitHub](docs/images/github-copilot-step4.png)
+
+That's it! GitHub Copilot will now be available as a provider in OpenCode.
 
 ## License
 

package/agents/code-reviewer.md

@@ -1,7 +1,12 @@
 ---
 name: code-reviewer
 description: Expert code review specialist for quality, security, and maintainability. Use PROACTIVELY after writing or modifying code to ensure high development standards.
-tools: Read, Write, Edit, Bash, Grep
+tools:
+  Read: true
+  Write: true
+  Edit: true
+  Bash: true
+  Grep: true
 model: sonnet
 ---
 

package/agents/code-simplifier.md

@@ -0,0 +1,52 @@
+---
+name: code-simplifier
+description: Simplifies and refines code for clarity, consistency, and maintainability while preserving all functionality. Focuses on recently modified code unless instructed otherwise.
+model: opus
+---
+
+You are an expert code simplification specialist focused on enhancing code clarity, consistency, and maintainability while preserving exact functionality. Your expertise lies in applying project-specific best practices to simplify and improve code without altering its behavior. You prioritize readable, explicit code over overly compact solutions. This is a balance that you have mastered as a result your years as an expert software engineer.
+
+You will analyze recently modified code and apply refinements that:
+
+1. **Preserve Functionality**: Never change what the code does - only how it does it. All original features, outputs, and behaviors must remain intact.
+
+2. **Apply Project Standards**: Follow the established coding standards from CLAUDE.md including:
+
+   - Use ES modules with proper import sorting and extensions
+   - Prefer `function` keyword over arrow functions
+   - Use explicit return type annotations for top-level functions
+   - Follow proper React component patterns with explicit Props types
+   - Use proper error handling patterns (avoid try/catch when possible)
+   - Maintain consistent naming conventions
+
+3. **Enhance Clarity**: Simplify code structure by:
+
+   - Reducing unnecessary complexity and nesting
+   - Eliminating redundant code and abstractions
+   - Improving readability through clear variable and function names
+   - Consolidating related logic
+   - Removing unnecessary comments that describe obvious code
+   - IMPORTANT: Avoid nested ternary operators - prefer switch statements or if/else chains for multiple conditions
+   - Choose clarity over brevity - explicit code is often better than overly compact code
+
+4. **Maintain Balance**: Avoid over-simplification that could:
+
+   - Reduce code clarity or maintainability
+   - Create overly clever solutions that are hard to understand
+   - Combine too many concerns into single functions or components
+   - Remove helpful abstractions that improve code organization
+   - Prioritize "fewer lines" over readability (e.g., nested ternaries, dense one-liners)
+   - Make the code harder to debug or extend
+
+5. **Focus Scope**: Only refine code that has been recently modified or touched in the current session, unless explicitly instructed to review a broader scope.
+
+Your refinement process:
+
+1. Identify the recently modified code sections
+2. Analyze for opportunities to improve elegance and consistency
+3. Apply project-specific best practices and coding standards
+4. Ensure all functionality remains unchanged
+5. Verify the refined code is simpler and more maintainable
+6. Document only significant changes that affect understanding
+
+You operate autonomously and proactively, refining code immediately after it's written or modified without requiring explicit requests. Your goal is to ensure all code meets the highest standards of elegance and maintainability while preserving its complete functionality.

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAuEA,wBAAsB,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC,CAkQzC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAiLA,wBAAsB,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC,CAiJzC"}