claudeguide-engineer 1.14.8

package/.claude/hooks/telegram_notify.sh

@@ -0,0 +1,158 @@
+#!/bin/bash
+
+# Telegram Notification Hook for Claude Code (Project-Specific)
+# This hook sends a notification to Telegram when Claude finishes a task
+
+set -euo pipefail
+
+# Load environment variables with priority: process.env > .claude/.env > .claude/hooks/.env
+load_env() {
+    # 1. Start with lowest priority: .claude/hooks/.env
+    if [[ -f "$(dirname "$0")/.env" ]]; then
+        set -a
+        source "$(dirname "$0")/.env"
+        set +a
+    fi
+
+    # 2. Override with .claude/.env
+    if [[ -f .claude/.env ]]; then
+        set -a
+        source .claude/.env
+        set +a
+    fi
+
+    # 3. Process env (already loaded) has highest priority - no action needed
+    # Variables already in process.env will not be overwritten by 'source'
+}
+
+load_env
+
+# Read JSON input from stdin
+INPUT=$(cat)
+
+# Extract relevant information from the hook input
+HOOK_TYPE=$(echo "$INPUT" | jq -r '.hookType // "unknown"')
+PROJECT_DIR=$(echo "$INPUT" | jq -r '.projectDir // ""')
+TIMESTAMP=$(date '+%Y-%m-%d %H:%M:%S')
+SESSION_ID=$(echo "$INPUT" | jq -r '.sessionId // ""')
+PROJECT_NAME=$(basename "$PROJECT_DIR")
+
+# Configuration - these will be set via environment variables
+TELEGRAM_BOT_TOKEN="${TELEGRAM_BOT_TOKEN:-}"
+TELEGRAM_CHAT_ID="${TELEGRAM_CHAT_ID:-}"
+
+# Validate required environment variables
+if [[ -z "$TELEGRAM_BOT_TOKEN" ]]; then
+    echo "Error: TELEGRAM_BOT_TOKEN environment variable not set" >&2
+    exit 1
+fi
+
+if [[ -z "$TELEGRAM_CHAT_ID" ]]; then
+    echo "Error: TELEGRAM_CHAT_ID environment variable not set" >&2
+    exit 1
+fi
+
+# Function to send Telegram message
+send_telegram_message() {
+    local message="$1"
+    local url="https://api.telegram.org/bot${TELEGRAM_BOT_TOKEN}/sendMessage"
+    
+    # Escape special characters for JSON
+    local escaped_message=$(echo "$message" | jq -Rs .)
+    
+    local payload=$(cat <<EOF
+{
+    "chat_id": "${TELEGRAM_CHAT_ID}",
+    "text": ${escaped_message},
+    "parse_mode": "Markdown",
+    "disable_web_page_preview": true
+}
+EOF
+)
+    
+    curl -s -X POST \
+        -H "Content-Type: application/json" \
+        -d "$payload" \
+        "$url" > /dev/null
+}
+
+# Generate summary based on hook type
+case "$HOOK_TYPE" in
+    "Stop")
+        # Extract tool usage summary
+        TOOLS_USED=$(echo "$INPUT" | jq -r '.toolsUsed[]?.tool // empty' | sort | uniq -c | sort -nr)
+        FILES_MODIFIED=$(echo "$INPUT" | jq -r '.toolsUsed[]? | select(.tool == "Edit" or .tool == "Write" or .tool == "MultiEdit") | .parameters.file_path // empty' | sort | uniq)
+        
+        # Count operations
+        TOTAL_TOOLS=$(echo "$INPUT" | jq '.toolsUsed | length')
+        
+        # Build summary message
+        MESSAGE="🚀 *DevPocket Task Completed*
+        
+📅 *Time:* ${TIMESTAMP}
+📁 *Project:* ${PROJECT_NAME}
+🔧 *Total Operations:* ${TOTAL_TOOLS}
+🆔 *Session:* ${SESSION_ID:0:8}...
+
+*Tools Used:*"
+
+        if [[ -n "$TOOLS_USED" ]]; then
+            MESSAGE="${MESSAGE}
+\`\`\`
+${TOOLS_USED}
+\`\`\`"
+        else
+            MESSAGE="${MESSAGE}
+None"
+        fi
+
+        if [[ -n "$FILES_MODIFIED" ]]; then
+            MESSAGE="${MESSAGE}
+
+*Files Modified:*"
+            while IFS= read -r file; do
+                if [[ -n "$file" ]]; then
+                    # Show relative path from project root
+                    relative_file=$(echo "$file" | sed "s|^${PROJECT_DIR}/||")
+                    MESSAGE="${MESSAGE}
+• ${relative_file}"
+                fi
+            done <<< "$FILES_MODIFIED"
+        fi
+        
+        MESSAGE="${MESSAGE}
+
+📍 *Location:* \`${PROJECT_DIR}\`"
+        ;;
+        
+    "SubagentStop")
+        SUBAGENT_TYPE=$(echo "$INPUT" | jq -r '.subagentType // "unknown"')
+        MESSAGE="🤖 *DevPocket Subagent Completed*
+
+📅 *Time:* ${TIMESTAMP}
+📁 *Project:* ${PROJECT_NAME}
+🔧 *Agent Type:* ${SUBAGENT_TYPE}
+🆔 *Session:* ${SESSION_ID:0:8}...
+
+Specialized agent completed its task.
+
+📍 *Location:* \`${PROJECT_DIR}\`"
+        ;;
+        
+    *)
+        MESSAGE="📝 *DevPocket Code Event*
+
+📅 *Time:* ${TIMESTAMP}
+📁 *Project:* ${PROJECT_NAME}
+📋 *Event:* ${HOOK_TYPE}
+🆔 *Session:* ${SESSION_ID:0:8}...
+
+📍 *Location:* \`${PROJECT_DIR}\`"
+        ;;
+esac
+
+# Send the notification
+send_telegram_message "$MESSAGE"
+
+# Log the notification (optional)
+echo "Telegram notification sent for $HOOK_TYPE event in project $PROJECT_NAME" >&2

package/.claude/metadata.json

@@ -0,0 +1,15 @@
+{
+  "version": "1.14.8",
+  "name": "claudeGuide-engineer",
+  "description": "A comprehensive boilerplate template for building professional software projects with CLI Coding Agents (Claude Code and Open Code).",
+  "buildDate": "2025-11-17T09:40:42.279Z",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/claudeGuide/claudeGuide-engineer.git"
+  },
+  "download": {
+    "lastDownloadedAt": null,
+    "downloadedBy": null,
+    "installCount": 0
+  }
+}

package/.claude/settings.json

@@ -0,0 +1,32 @@
+{
+  "includeCoAuthoredBy": false,
+  "statusLine": {
+    "type": "command",
+    "command": "node .claude/statusline.js",
+    "padding": 0
+  },
+  "hooks": {
+    "PreToolUse": [
+      {
+        "matcher": "Bash",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"$CLAUDE_PROJECT_DIR\"/.claude/hooks/scout-block.js"
+          }
+        ]
+      }
+    ],
+    "PostToolUse": [
+      {
+        "matcher": "Write|Edit",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"$CLAUDE_PROJECT_DIR\"/.claude/hooks/modularization-hook.js"
+          }
+        ]
+      }
+    ]
+  }
+}

package/.claude/skills/.env.example

@@ -0,0 +1,32 @@
+# Claude Code - Project-Level Environment Variables
+# Priority: process.env > .claude/.env > .claude/hooks/.env
+# Copy this file to .env and set your API keys and configuration
+
+# ============================================
+# Claude Code Notification Hooks
+# ============================================
+# Discord Webhook URL (for Discord notifications)
+# Get from: Server Settings → Integrations → Webhooks → New Webhook
+DISCORD_WEBHOOK_URL=
+
+# Telegram Bot Token (for Telegram notifications)
+# Get from: @BotFather in Telegram
+TELEGRAM_BOT_TOKEN=
+
+# Telegram Chat ID (your chat ID or group ID)
+# Get from: https://api.telegram.org/bot<BOT_TOKEN>/getUpdates
+TELEGRAM_CHAT_ID=
+
+# ============================================
+# Google Gemini API Key (for Gemini skills)
+# ============================================
+# Get your key at: https://aistudio.google.com/apikey
+GEMINI_API_KEY=your-gemini-api-key-here
+
+# ==== Vertex AI (Optional) ====
+# Uncomment to use Vertex AI instead of AI Studio
+# GEMINI_USE_VERTEX=true
+# VERTEX_PROJECT_ID=your-gcp-project-id
+# VERTEX_LOCATION=us-central1
+
+# Add other API keys and configuration as needed

package/.claude/skills/INSTALLATION.md

@@ -0,0 +1,280 @@
+# Skills Installation Guide
+
+This guide explains how to install dependencies for Claude Code skills.
+
+## Overview
+
+Skills are organized into groups with Python utility scripts. Each skill's scripts directory contains a `requirements.txt` file listing dependencies.
+
+## Quick Start
+
+### Option 1: Install All Dependencies (Recommended)
+
+```bash
+# Create virtual environment
+python3 -m venv .venv
+source .venv/bin/activate  # On Windows: .venv\Scripts\activate
+
+# Install all skill dependencies
+pip install -r .claude/skills/ai-multimodal/scripts/requirements.txt
+
+# Install test dependencies for development
+pip install pytest pytest-cov pytest-mock
+```
+
+### Option 2: Install Per-Skill
+
+Navigate to specific skill and install:
+
+```bash
+cd .claude/skills/ai-multimodal/scripts
+pip install -r requirements.txt
+```
+
+## Skills Dependencies
+
+### Python Package Dependencies
+
+Most skills use only Python standard library. Only **ai-multimodal** requires external packages:
+
+**ai-multimodal** (`.claude/skills/ai-multimodal/scripts/requirements.txt`):
+- `google-genai>=0.1.0` - Google Gemini API
+- `pypdf>=4.0.0` - PDF processing
+- `python-docx>=1.0.0` - DOCX conversion
+- `docx2pdf>=0.1.8` - PDF conversion (Windows only)
+- `markdown>=3.5.0` - Markdown processing
+- `Pillow>=10.0.0` - Image processing
+- `python-dotenv>=1.0.0` - Environment variables
+
+### System Tool Dependencies
+
+Several skills require external CLI tools:
+
+#### media-processing
+- **FFmpeg**: Video/audio processing
+  - Ubuntu/Debian: `sudo apt-get install ffmpeg`
+  - macOS: `brew install ffmpeg`
+  - Windows: `choco install ffmpeg`
+- **ImageMagick**: Image processing
+  - Ubuntu/Debian: `sudo apt-get install imagemagick`
+  - macOS: `brew install imagemagick`
+  - Windows: `choco install imagemagick`
+
+#### devops
+- **Cloudflare Wrangler**: `npm install -g wrangler`
+- **Docker**: https://docs.docker.com/get-docker/
+- **Google Cloud CLI**: https://cloud.google.com/sdk/docs/install
+
+#### better-auth, repomix, shopify
+- **Node.js 18+**: https://nodejs.org/
+- **Better Auth**: `npm install better-auth`
+- **Repomix**: `npm install -g repomix`
+- **Shopify CLI**: `npm install -g @shopify/cli @shopify/theme`
+
+#### databases
+- **PostgreSQL client**: `sudo apt-get install postgresql-client` (Linux)
+- **MongoDB Shell**: https://www.mongodb.com/try/download/shell
+- **MongoDB Tools**: https://www.mongodb.com/try/download/database-tools
+
+#### web-frameworks, ui-styling
+- **Node.js 18+**: https://nodejs.org/
+- **pnpm**: `npm install -g pnpm`
+- **yarn**: `npm install -g yarn`
+
+## Installation by Platform
+
+### Linux (Ubuntu/Debian)
+
+```bash
+# Python environment
+python3 -m venv .venv
+source .venv/bin/activate
+
+# Python packages (ai-multimodal only)
+cd .claude/skills/ai-multimodal/scripts
+pip install -r requirements.txt
+
+# System tools
+sudo apt-get update
+sudo apt-get install -y ffmpeg imagemagick postgresql-client
+
+# Node.js and tools
+curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
+sudo apt-get install -y nodejs
+npm install -g pnpm wrangler repomix @shopify/cli
+```
+
+### macOS
+
+```bash
+# Python environment
+python3 -m venv .venv
+source .venv/bin/activate
+
+# Python packages (ai-multimodal only)
+cd .claude/skills/ai-multimodal/scripts
+pip install -r requirements.txt
+
+# System tools via Homebrew
+brew install ffmpeg imagemagick postgresql
+
+# Node.js and tools
+brew install node
+npm install -g pnpm wrangler repomix @shopify/cli
+```
+
+### Windows
+
+```powershell
+# Python environment
+python -m venv .venv
+.venv\Scripts\activate
+
+# Python packages (ai-multimodal only)
+cd .claude\skills\ai-multimodal\scripts
+pip install -r requirements.txt
+
+# System tools via Chocolatey
+choco install ffmpeg imagemagick nodejs
+
+# Node.js tools
+npm install -g pnpm wrangler repomix @shopify/cli
+```
+
+## Testing Dependencies
+
+All skills include test dependencies in `requirements.txt`:
+
+```txt
+pytest>=8.0.0
+pytest-cov>=4.1.0
+pytest-mock>=3.12.0
+```
+
+To run tests for a skill:
+
+```bash
+cd .claude/skills/{skill-name}/scripts
+python -m pytest tests/ -v --cov=. --cov-report=term-missing
+```
+
+## Environment Variables
+
+Skills respect environment variable loading priority:
+
+1. **process.env** (highest priority - runtime environment)
+2. **`.claude/skills/{skill-name}/.env`** (skill-specific config)
+3. **`.claude/skills/.env`** (shared skills config)
+4. **`.claude/.env`** (global Claude config)
+
+Example `.env` files are provided where needed (e.g., `devops/.env.example`).
+
+## Troubleshooting
+
+### "externally-managed-environment" Error
+
+If you see this error when installing packages:
+
+```bash
+# Use virtual environment (recommended)
+python3 -m venv .venv
+source .venv/bin/activate
+pip install -r requirements.txt
+
+# Or use pipx for CLI tools
+pipx install google-genai
+```
+
+### Missing System Tools
+
+If scripts fail with "command not found":
+
+```bash
+# Check if tool is installed
+which ffmpeg
+which docker
+which node
+
+# Verify tool works
+ffmpeg -version
+docker --version
+node --version
+```
+
+### Permission Errors
+
+On Linux/macOS, you may need to make scripts executable:
+
+```bash
+chmod +x .claude/skills/*/scripts/*.py
+```
+
+## Minimal Installation
+
+If you only want to use specific skills:
+
+**For ai-multimodal only:**
+```bash
+pip install google-genai pypdf python-docx markdown Pillow python-dotenv
+```
+
+**For media-processing only:**
+```bash
+# macOS
+brew install ffmpeg imagemagick
+
+# Linux
+sudo apt-get install ffmpeg imagemagick
+```
+
+**For other skills:**
+Most other skills (better-auth, repomix, shopify, devops, web-frameworks, ui-styling, databases) use only Python stdlib and require no `pip install`.
+
+## Development Setup
+
+For contributors working on skills:
+
+```bash
+# Install all test dependencies
+pip install pytest pytest-cov pytest-mock
+
+# Install pre-commit hooks (if available)
+pre-commit install
+
+# Run all tests
+pytest .claude/skills/*/scripts/tests/ -v
+
+# Check coverage across all skills
+pytest .claude/skills/*/scripts/tests/ --cov=.claude/skills --cov-report=html
+```
+
+## Skill-Specific Notes
+
+### ai-multimodal
+- Requires `GEMINI_API_KEY` in environment
+- Get API key: https://aistudio.google.com/app/apikey
+- Windows users: `docx2pdf` requires Microsoft Word installed
+
+### media-processing
+- FFmpeg must be in PATH
+- ImageMagick must be in PATH
+- Test with: `ffmpeg -version` and `convert -version`
+
+### devops
+- Cloudflare: Requires `CLOUDFLARE_API_TOKEN` and `CLOUDFLARE_ACCOUNT_ID`
+- GCloud: Requires `GOOGLE_APPLICATION_CREDENTIALS` path to service account JSON
+- Docker: Must have Docker daemon running
+
+### shopify
+- Requires Shopify CLI authentication: `shopify auth login`
+- Partner account needed for app development
+
+## Getting Help
+
+If dependencies fail to install or scripts don't work:
+
+1. Check the skill's `scripts/requirements.txt` for specific versions
+2. Verify system tools are installed and in PATH
+3. Check environment variables are set correctly
+4. Review skill's `SKILL.md` for additional setup instructions
+5. Open an issue: https://github.com/anthropics/claude-code/issues

package/.claude/skills/README.md

@@ -0,0 +1,111 @@
+# Skills
+Skills are folders of instructions, scripts, and resources that Claude loads dynamically to improve performance on specialized tasks. Skills teach Claude how to complete specific tasks in a repeatable way, whether that's creating documents with your company's brand guidelines, analyzing data using your organization's specific workflows, or automating personal tasks.
+
+For more information, check out:
+- [What are skills?](https://support.claude.com/en/articles/12512176-what-are-skills)
+- [Using skills in Claude](https://support.claude.com/en/articles/12512180-using-skills-in-claude)
+- [How to create custom skills](https://support.claude.com/en/articles/12512198-creating-custom-skills)
+- [Equipping agents for the real world with Agent Skills](https://anthropic.com/engineering/equipping-agents-for-the-real-world-with-agent-skills)
+
+# About This Repository
+
+This repository contains example skills that demonstrate what's possible with Claude's skills system. These examples range from creative applications (art, music, design) to technical tasks (testing web apps, MCP server generation) to enterprise workflows (communications, branding, etc.).
+
+Each skill is self-contained in its own directory with a `SKILL.md` file containing the instructions and metadata that Claude uses. Browse through these examples to get inspiration for your own skills or to understand different patterns and approaches.
+
+The example skills in this repo are open source (Apache 2.0). We've also included the document creation & editing skills that power [Claude's document capabilities](https://www.anthropic.com/news/create-files) under the hood in the [`document-skills/`](./document-skills/) folder. These are source-available, not open source, but we wanted to share these with developers as a reference for more complex skills that are actively used in a production AI application.
+
+**Note:** These are reference examples for inspiration and learning. They showcase general-purpose capabilities rather than organization-specific workflows or sensitive content.
+
+## Disclaimer
+
+**These skills are provided for demonstration and educational purposes only.** While some of these capabilities may be available in Claude, the implementations and behaviors you receive from Claude may differ from what is shown in these examples. These examples are meant to illustrate patterns and possibilities. Always test skills thoroughly in your own environment before relying on them for critical tasks.
+
+# Example Skills
+
+This repository includes a diverse collection of example skills demonstrating different capabilities:
+
+## Creative & Design
+- **algorithmic-art** - Create generative art using p5.js with seeded randomness, flow fields, and particle systems
+- **canvas-design** - Design beautiful visual art in .png and .pdf formats using design philosophies
+- **slack-gif-creator** - Create animated GIFs optimized for Slack's size constraints
+
+## Development & Technical
+- **artifacts-builder** - Build complex claude.ai HTML artifacts using React, Tailwind CSS, and shadcn/ui components
+- **mcp-server** - Guide for creating high-quality MCP servers to integrate external APIs and services
+- **webapp-testing** - Test local web applications using Playwright for UI verification and debugging
+
+## Enterprise & Communication
+- **brand-guidelines** - Apply Anthropic's official brand colors and typography to artifacts
+- **internal-comms** - Write internal communications like status reports, newsletters, and FAQs
+- **theme-factory** - Style artifacts with 10 pre-set professional themes or generate custom themes on-the-fly
+
+## Meta Skills
+- **skill-creator** - Guide for creating effective skills that extend Claude's capabilities
+- **template-skill** - A basic template to use as a starting point for new skills
+
+# Document Skills
+
+The `document-skills/` subdirectory contains skills that Anthropic developed to help Claude create various document file formats. These skills demonstrate advanced patterns for working with complex file formats and binary data:
+
+- **docx** - Create, edit, and analyze Word documents with support for tracked changes, comments, formatting preservation, and text extraction
+- **pdf** - Comprehensive PDF manipulation toolkit for extracting text and tables, creating new PDFs, merging/splitting documents, and handling forms
+- **pptx** - Create, edit, and analyze PowerPoint presentations with support for layouts, templates, charts, and automated slide generation
+- **xlsx** - Create, edit, and analyze Excel spreadsheets with support for formulas, formatting, data analysis, and visualization
+
+**Important Disclaimer:** These document skills are point-in-time snapshots and are not actively maintained or updated. Versions of these skills ship pre-included with Claude. They are primarily intended as reference examples to illustrate how Anthropic approaches developing more complex skills that work with binary file formats and document structures.
+
+# Try in Claude Code, Claude.ai, and the API
+
+## Claude Code
+You can register this repository as a Claude Code Plugin marketplace by running the following command in Claude Code:
+```
+/plugin marketplace add anthropics/skills
+```
+
+After installing the plugin, you can use the skill by just mentioning it. For instance, if you install the document-skills plugin from the marketplace, you can ask Claude Code to do something like: "use the pdf skill to extract the form fields from path/to/some-file.pdf"
+
+## Claude.ai
+
+These example skills are all already available to paid plans in Claude.ai. 
+
+To use any skill from this repository or upload custom skills, follow the instructions in [Using skills in Claude](https://support.claude.com/en/articles/12512180-using-skills-in-claude#h_a4222fa77b).
+
+## Claude API
+
+You can use Anthropic's pre-built skills, and upload custom skills, via the Claude API. See the [Skills API Quickstart](https://docs.claude.com/en/api/skills-guide#creating-a-skill) for more.
+
+# Creating a Basic Skill
+
+Skills are simple to create - just a folder with a `SKILL.md` file containing YAML frontmatter and instructions. You can use the **template-skill** in this repository as a starting point:
+
+```markdown
+---
+name: my-skill-name
+description: A clear description of what this skill does and when to use it
+---
+
+# My Skill Name
+
+[Add your instructions here that Claude will follow when this skill is active]
+
+## Examples
+- Example usage 1
+- Example usage 2
+
+## Guidelines
+- Guideline 1
+- Guideline 2
+```
+
+The frontmatter requires only two fields:
+- `name` - A unique identifier for your skill (lowercase, hyphens for spaces)
+- `description` - A complete description of what the skill does and when to use it
+
+The markdown content below contains the instructions, examples, and guidelines that Claude will follow. For more details, see [How to create custom skills](https://support.claude.com/en/articles/12512198-creating-custom-skills).
+
+# Partner Skills
+
+Skills are a great way to teach Claude how to get better at using specific pieces of software. As we see awesome example skills from partners, we may highlight some of them here:
+
+- **Notion** - [Notion Skills for Claude](https://www.notion.so/notiondevs/Notion-Skills-for-Claude-28da4445d27180c7af1df7d8615723d0)