### Quick Start Example Source: https://github.com/codewithbehnam/cc-docs/blob/main/skills/language-specific/python-packaging/SKILL.md A simple Python code snippet demonstrating how to import and use a function from an installed package. ```python from my_package import something result = something.do_stuff() ``` -------------------------------- ### Setup Script Example Source: https://github.com/codewithbehnam/cc-docs/blob/main/cheatsheets/claude-code-on-the-web.md A bash script to run before Claude Code launches in new sessions. This example updates package lists, installs GitHub CLI, and installs Node.js and Python dependencies. ```bash #!/bin/bash apt update && apt install -y gh npm install pip install -r requirements.txt ``` -------------------------------- ### Complete Static Site Deployment Example Source: https://github.com/codewithbehnam/cc-docs/blob/main/skills/devops-infrastructure/agent-sandboxes/examples/05_host_frontend.md A step-by-step guide to initializing a sandbox, creating a static site, starting a server, and obtaining its public URL. ```bash # 1. Initialize uv run sbx init --timeout 1800 # Captured: sbx_site456 # 2. Create structure uv run sbx files mkdir sbx_site456 /home/user/site # 3. Create index.html uv run sbx files write sbx_site456 /home/user/site/index.html " My Site

Welcome!

This site is running on E2B at port 5173

" # 4. Start server on port 5173 uv run sbx exec sbx_site456 "python -m http.server 5173" --background --cwd /home/user/site # 5. Get public URL (capture in your context, not variable) uv run sbx sandbox get-host sbx_site456 --port 5173 # Returns: https://5173-sbx_site456.e2b.app # YOU remember: url = "https://5173-sbx_site456.e2b.app" # 6. Share with user (using the URL you captured) echo "Visit: https://5173-sbx_site456.e2b.app" # 7. Sandbox auto-terminates after 30 minutes # Never kill unless explicitly requested ``` -------------------------------- ### Development Setup Example Source: https://github.com/codewithbehnam/cc-docs/blob/main/skills/language-specific/python-packaging/SKILL.md Commands to clone a repository, install development dependencies, and run tests using pytest. ```bash git clone https://github.com/username/my-package.git cd my-package pip install -e ".[dev]" pytest ``` -------------------------------- ### Basic SAST Tool Setup Source: https://github.com/codewithbehnam/cc-docs/blob/main/skills/security/sast-configuration/SKILL.md Quick start commands for installing and running Semgrep, launching SonarQube with Docker, and creating a CodeQL database. ```bash # Semgrep quick start pip install semgrep semgrep --config=auto --error ``` ```bash # SonarQube with Docker docker run -d --name sonarqube -p 9000:9000 sonarqube:latest ``` ```bash # CodeQL CLI setup gh extension install github/gh-codeql codeql database create mydb --language=python ``` -------------------------------- ### Design System Setup Completion Summary Source: https://github.com/codewithbehnam/cc-docs/blob/main/commands/development/design-system-setup.md Summary of files created and quick start instructions after a successful design system setup. ```text Design System Setup Complete! Created files: - .ui-design/design-system.json (master configuration) - .ui-design/tokens/tokens.css (CSS custom properties) - .ui-design/tokens/tailwind.config.js (Tailwind extension) - .ui-design/tokens/tokens.ts (TypeScript module) - .ui-design/docs/design-system.md (documentation) Quick start: 1. CSS: @import '.ui-design/tokens/tokens.css'; 2. Tailwind: Spread in your tailwind.config.js 3. TypeScript: import { colors } from '.ui-design/tokens/tokens'; ``` -------------------------------- ### Example Plugin Hint Prompt Source: https://github.com/codewithbehnam/cc-docs/blob/main/claude-code-docs/plugin-hints.md This is an example of the prompt a user sees when Claude Code suggests installing a plugin. ```text ───────────────────────────────────────────────────────────── Plugin Recommendation The example-cli command suggests installing a plugin. Plugin: example-cli Marketplace: claude-plugins-official Official integration for example-cli deployments Would you like to install it? ❯ 1. Yes, install example-cli 2. No 3. No, and don't show plugin installation hints again ───────────────────────────────────────────────────────────── ``` -------------------------------- ### Skill File Structure Example (Minimal) Source: https://github.com/codewithbehnam/cc-docs/blob/main/skills/productivity/create-agent-skills/SKILL.md Create a minimal skill file with a name, description, and a quick start example. This serves as the entry point for the skill. ```markdown --- name: my-skill description: What it does. Use when [trigger conditions]. --- # Skill Title ## Quick Start [Immediate actionable example] ## Instructions [Core guidance] ## Examples [Concrete input/output pairs] ``` -------------------------------- ### Migration from Pip + requirements.txt to UV Source: https://github.com/codewithbehnam/cc-docs/blob/main/skills/language-specific/uv-package-manager/SKILL.md Guides for migrating from a pip and requirements.txt setup to UV, showing both direct pip install and a more integrated UV approach. ```bash # Before python -m venv .venv source .venv/bin/activate pip install -r requirements.txt # After uv venv uv pip install -r requirements.txt # Or better: uv init uv add -r requirements.txt ``` -------------------------------- ### Good vs. Bad XML Quick Start for Tool Options Source: https://github.com/codewithbehnam/cc-docs/blob/main/skills/productivity/create-agent-skills/references/common-patterns.md Advises providing a single default approach in the quick start guide, with an escape hatch for special cases, to avoid decision paralysis. ```xml You can use pypdf, or pdfplumber, or PyMuPDF, or pdf2image, or pdfminer, or tabula-py... ``` ```xml Use pdfplumber for text extraction: ```python import pdfplumber ``` For scanned PDFs requiring OCR, use pdf2image with pytesseract instead. ``` -------------------------------- ### Quick Start: Install Dependencies Source: https://github.com/codewithbehnam/cc-docs/blob/main/skills/frontend-development/react-native-architecture/SKILL.md Commands to install essential dependencies for Expo Router, navigation, local storage, and secure storage. ```bash npx expo install expo-router expo-status-bar react-native-safe-area-context npx expo install @react-native-async-storage/async-storage npx expo install expo-secure-store expo-haptics ``` -------------------------------- ### CLI Usage Examples Source: https://github.com/codewithbehnam/cc-docs/blob/main/skills/language-specific/python-packaging/SKILL.md These examples demonstrate how to install and use a command-line tool registered via pyproject.toml, showing different command invocations with arguments and options. ```bash pip install -e . my-tool greet World my-tool greet Alice --greeting="Hi" my-tool repeat --count=3 ``` -------------------------------- ### HTTP GET Method Examples Source: https://github.com/codewithbehnam/cc-docs/blob/main/skills/api-architecture/api-design-principles/references/rest-best-practices.md Demonstrates common GET requests for retrieving resources, including lists, specific items, and paginated results. ```http GET /api/users → 200 OK (with list) GET /api/users/{id} → 200 OK or 404 Not Found GET /api/users?page=2 → 200 OK (paginated) ``` -------------------------------- ### Complete Enterprise Gateway Setup Source: https://github.com/codewithbehnam/cc-docs/blob/main/templates/cloud-providers/LLM-GATEWAY-SETUP.md A comprehensive example for an enterprise setup, including gateway base URL, corporate proxy settings, and a custom API key helper script. ```json { "env": { "ANTHROPIC_BASE_URL": "https://ai-gateway.corp.example.com", "HTTPS_PROXY": "https://proxy.corp.example.com:8080", "NODE_EXTRA_CA_CERTS": "/etc/ssl/certs/corp-ca.pem" }, "apiKeyHelper": "~/bin/get-corp-api-key.sh" } ``` -------------------------------- ### Issue Implementation with Setup Steps Source: https://github.com/codewithbehnam/cc-docs/blob/main/templates/ci-cd/GITHUB-ACTIONS-ISSUE-IMPL.md This snippet demonstrates how to include setup steps before the Claude code action runs. It configures Node.js, installs dependencies using npm ci, and then proceeds with issue implementation. ```yaml steps: - uses: actions/checkout@v4 with: fetch-depth: 0 # Set up the development environment first - uses: actions/setup-node@v4 with: node-version: 20 cache: npm - run: npm ci - uses: anthropics/claude-code-action@v1 with: anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }} claude_args: "--max-turns 25" prompt: | The development environment is already set up. Node.js and all npm dependencies are installed. Implement the feature described in this issue. Run `npm test` to verify your changes work. Run `npm run lint` to ensure code quality. ``` -------------------------------- ### CI/CD Integration Workflow Source: https://github.com/codewithbehnam/cc-docs/blob/main/skills/language-specific/uv-package-manager/SKILL.md Example GitHub Actions workflow for setting up uv, installing Python, syncing dependencies, and running tests/linting. ```yaml # .github/workflows/test.yml name: Tests on: [push, pull_request] jobs: test: runs-on: ubuntu-latest steps: - uses: actions/checkout@v4 - name: Install uv uses: astral-sh/setup-uv@v2 with: enable-cache: true - name: Set up Python run: uv python install 3.12 - name: Install dependencies run: uv sync --all-extras --dev - name: Run tests run: uv run pytest - name: Run linting run: | uv run ruff check . uv run black --check . ``` -------------------------------- ### User Guide Template (Markdown) Source: https://github.com/codewithbehnam/cc-docs/blob/main/commands/documentation/doc-generate.md A Markdown template for creating user guides, covering sections like Getting Started, Common Tasks, and Troubleshooting, with examples for creating, editing, and deleting features. ```markdown # User Guide ## Getting Started ### Creating Your First ${FEATURE} 1. **Navigate to the Dashboard** Click on the ${FEATURE} tab in the main navigation menu. 2. **Click "Create New"** You'll find the "Create New" button in the top right corner. 3. **Fill in the Details** - **Name**: Enter a descriptive name - **Description**: Add optional details - **Settings**: Configure as needed 4. **Save Your Changes** Click "Save" to create your ${FEATURE}. ### Common Tasks #### Editing ${FEATURE} 1. Find your ${FEATURE} in the list 2. Click the "Edit" button 3. Make your changes 4. Click "Save" #### Deleting ${FEATURE} > ⚠️ **Warning**: Deletion is permanent and cannot be undone. 1. Find your ${FEATURE} in the list 2. Click the "Delete" button 3. Confirm the deletion ### Troubleshooting | Error | Meaning | Solution | | ------------------- | ----------------------- | --------------- | | "Name required" | The name field is empty | Enter a name | | "Permission denied" | You don't have access | Contact admin | | "Server error" | Technical issue | Try again later | ``` -------------------------------- ### Setup Tutorials Repository Source: https://github.com/codewithbehnam/cc-docs/blob/main/skills/productivity/coding-tutor/SKILL.md Run this script to ensure the central tutorials repository exists. It creates the directory `~/coding-tutor-tutorials/` if it doesn't already exist, where all tutorials and learner profiles are stored. ```bash python3 ${CLAUDE_PLUGIN_ROOT}/skills/coding-tutor/scripts/setup_tutorials.py ``` -------------------------------- ### Trigger GitHub App Installation Source: https://github.com/codewithbehnam/cc-docs/blob/main/guides/ci-cd-setup.md Run this command within your repository's local clone to start the guided installation of the Claude GitHub app. ```text /install-github-app ``` -------------------------------- ### Project Setup and Commands Source: https://github.com/codewithbehnam/cc-docs/blob/main/templates/claude-md-starters/CLAUDE-MD-TYPESCRIPT.md Essential commands for installing dependencies, running development servers, building for production, testing, linting, formatting, and type checking. ```bash npm install npm run dev npm run build npm test npm run lint npm run format npx tsc --noEmit ``` -------------------------------- ### Setup Script to Install GitHub CLI Source: https://github.com/codewithbehnam/cc-docs/blob/main/claude-code-docs/claude-code-on-the-web.md This Bash script installs the 'gh' CLI using apt. Setup scripts run as root on Ubuntu 24.04. If a script exits non-zero, the session fails to start, so append '|| true' to non-critical commands to prevent blocking. ```bash #!/bin/bash apt update && apt install -y gh ``` -------------------------------- ### README Structure Example Source: https://github.com/codewithbehnam/cc-docs/blob/main/skills/language-specific/python-code-style/SKILL.md A standard README structure for a Python project, including installation, quick start, and development sections. ```markdown # Project Name Brief description of what the project does. ## Installation ```bash pip install myproject ``` ## Quick Start ```python from myproject import Client client = Client(api_key="...") result = client.process(data) ``` ## Configuration Document environment variables and configuration options. ## Development ```bash pip install -e ".[dev]" pytest ``` ``` -------------------------------- ### C Extensions Build Configuration (setup.py) Source: https://github.com/codewithbehnam/cc-docs/blob/main/skills/language-specific/python-packaging/SKILL.md Example setup.py file for configuring C extension modules using setuptools.Extension. ```python # setup.py from setuptools import setup, Extension setup( ext_modules=[ Extension( "my_package.fast_module", sources=["src/fast_module.c"], include_dirs=["src/include"], ) ] ) ``` -------------------------------- ### Design System Setup Next Steps Source: https://github.com/codewithbehnam/cc-docs/blob/main/commands/development/design-system-setup.md Outline of recommended actions after initial design system setup, including customization and component creation. ```text Next steps: 1. Review and customize tokens as needed 2. Run /ui-design:create-component to build with your design system 3. Run /ui-design:design-review to validate existing UI against tokens Need to modify tokens? Run /ui-design:design-system-setup --preset {preset} ``` -------------------------------- ### Implement Pre-Install Hook in Helm Chart Source: https://github.com/codewithbehnam/cc-docs/blob/main/skills/devops-infrastructure/helm-chart-scaffolding/SKILL.md Example of a pre-install Helm hook defined as a Kubernetes Job. This hook runs before the main chart resources are installed, useful for database setup. ```yaml # templates/pre-install-job.yaml apiVersion: batch/v1 kind: Job metadata: name: {{ include "my-app.fullname" . }}-db-setup annotations: "helm.sh/hook": pre-install "helm.sh/hook-weight": "-5" "helm.sh/hook-delete-policy": hook-succeeded spec: template: spec: containers: - name: db-setup image: postgres:15 command: ["psql", "-c", "CREATE DATABASE myapp"] restartPolicy: Never ``` -------------------------------- ### Guiding Prompt Example (Good) Source: https://github.com/codewithbehnam/cc-docs/blob/main/skills/ai-ml/agent-native-architecture/references/system-prompt-design.md An example of a system prompt that guides the agent by focusing on the goal and desired outcome, allowing for agent judgment. ```markdown When creating summaries: - Be concise but complete - Highlight the most important points - Use your judgment about format The goal is clarity, not consistency. ``` -------------------------------- ### Create Tutorial Command Source: https://github.com/codewithbehnam/cc-docs/blob/main/skills/productivity/coding-tutor/SKILL.md Use this command to create a new tutorial markdown file with a predefined template. Specify the topic name and relevant concepts. ```bash python3 ${CLAUDE_PLUGIN_ROOT}/skills/coding-tutor/scripts/create_tutorial.py "Topic Name" --concepts "Concept1,Concept2" ``` -------------------------------- ### Configure Project-Level Hooks for Subagent Events Source: https://github.com/codewithbehnam/cc-docs/blob/main/claude-code-docs/sub-agents.md Set up 'SubagentStart' and 'SubagentStop' hooks in settings.json to trigger commands based on subagent lifecycle events. This example runs a setup script for 'db-agent' on start and a cleanup script for any subagent on stop. ```json { "hooks": { "SubagentStart": [ { "matcher": "db-agent", "hooks": [ { "type": "command", "command": "./scripts/setup-db-connection.sh" } ] } ], "SubagentStop": [ { "hooks": [ { "type": "command", "command": "./scripts/cleanup-db-connection.sh" } ] } ] } } ``` -------------------------------- ### Setup and Teardown for Test Files Source: https://github.com/codewithbehnam/cc-docs/blob/main/skills/language-specific/bats-testing-patterns/SKILL.md Use `setup` to prepare test environments and `teardown` to clean up after each test. This is useful for creating temporary directories and files. ```bash #!/usr/bin/env bats setup() { # Create directory structure mkdir -p "$TMPDIR/data/input" mkdir -p "$TMPDIR/data/output" # Create test fixtures echo "line1" > "$TMPDIR/data/input/file1.txt" echo "line2" > "$TMPDIR/data/input/file2.txt" # Initialize environment export DATA_DIR="$TMPDIR/data" export INPUT_DIR="$DATA_DIR/input" export OUTPUT_DIR="$DATA_DIR/output" } teardown() { rm -rf "$TMPDIR/data" } @test "Processes input files" { run my_process_script "$INPUT_DIR" "$OUTPUT_DIR" [ "$status" -eq 0 ] [ -f "$OUTPUT_DIR/file1.txt" ] } ``` -------------------------------- ### Complete Example: settings.json with all configurations Source: https://github.com/codewithbehnam/cc-docs/blob/main/templates/cloud-providers/AWS-BEDROCK-SETUP.md A comprehensive example of the `~/.claude/settings.json` file, including Bedrock enablement, AWS region, SSO profile, model pinning, and auto-refresh settings. ```json { "env": { "CLAUDE_CODE_USE_BEDROCK": "1", "AWS_REGION": "us-east-1", "AWS_PROFILE": "claude-profile", "ANTHROPIC_DEFAULT_OPUS_MODEL": "us.anthropic.claude-opus-4-6-v1", "ANTHROPIC_DEFAULT_SONNET_MODEL": "us.anthropic.claude-sonnet-4-6-v1", "ANTHROPIC_DEFAULT_HAIKU_MODEL": "us.anthropic.claude-haiku-4-5-v1" }, "awsAuthRefresh": "aws sso login --profile claude-profile" } ``` -------------------------------- ### Install and Start LiteLLM Proxy Source: https://github.com/codewithbehnam/cc-docs/blob/main/templates/cloud-providers/LLM-GATEWAY-SETUP.md Install the LiteLLM package with proxy support and start the proxy server. You can specify a model and port directly or use a configuration file. ```bash pip install litellm[proxy] litellm --model anthropic/claude-sonnet-4-6 --port 4000 ``` -------------------------------- ### Simple GET Request Example Source: https://github.com/codewithbehnam/cc-docs/blob/main/skills/productivity/create-agent-skills/references/api-security.md A basic example of a simple GET request using curl. It includes setting the Authorization header but does not demonstrate secure credential handling. ```bash curl -s -G \ -H "Authorization: Bearer $API_KEY" \ "https://api.example.com/endpoint" ``` -------------------------------- ### Tip: Initialize Project Memory with /init Source: https://github.com/codewithbehnam/cc-docs/blob/main/claude-code-docs/communications-kit.md Explains how to use the `/init` command to create a CLAUDE.md file, which stores project-specific information like build commands and conventions to improve session context. ```markdown 📁 *Tip: Stop re-explaining your repo every session* Telling Claude "we use pnpm, not npm" for the fifth time? There is a one-time fix. Run `/init` once per repo. Claude reads your project structure and writes a CLAUDE.md file with your build commands, architecture, and conventions. Every future session in that repo starts from this file automatically. Keep it under two screens. It is a cheat sheet, not documentation. *Try it now:* open your main repo, run `claude`, type `/init`. Thirty seconds, pays off every session after. 📖 CLAUDE.md and project memory → https://code.claude.com/docs/en/memory ``` -------------------------------- ### Run Installed Plugin Skill Source: https://github.com/codewithbehnam/cc-docs/blob/main/claude-code-docs/plugin-marketplaces.md Example of how to invoke a skill from an installed plugin, namespaced by the plugin name. ```shell /quality-review-plugin:quality-review ``` -------------------------------- ### Create Marketplace Directory Structure Source: https://github.com/codewithbehnam/cc-docs/blob/main/claude-code-docs/plugin-marketplaces.md Sets up the necessary directories for a local plugin marketplace and a sample plugin. ```bash mkdir -p my-marketplace/.claude-plugin mkdir -p my-marketplace/plugins/quality-review-plugin/.claude-plugin mkdir -p my-marketplace/plugins/quality-review-plugin/skills/quality-review ``` -------------------------------- ### Agent Onboarding Hint Example Source: https://github.com/codewithbehnam/cc-docs/blob/main/skills/ai-ml/agent-native-architecture/references/product-implications.md An example of how an agent can inform the user about its capabilities during an initial interaction. ```text Agent: "I can help you with your reading in several ways: - Research any book (web search + save findings) - Generate personalized introductions - Publish insights to your reading feed - Analyze themes across your library What interests you?" ``` -------------------------------- ### Install Processing Tools in Sandbox Source: https://github.com/codewithbehnam/cc-docs/blob/main/skills/devops-infrastructure/agent-sandboxes/examples/04_process_binary_files.md Install necessary tools and libraries within the sandbox environment. This example shows installing uv and the Pillow library for image processing. ```bash uv run sbx exec sbx_img456resize "curl -LsSf https://astral.sh/uv/install.sh | sh" --shell --timeout 120 ``` ```bash uv run sbx exec sbx_img456resize "/home/user/.local/bin/uv pip install --system pillow" ``` -------------------------------- ### Install TypeScript SDK Source: https://github.com/codewithbehnam/cc-docs/blob/main/skills/ai-ml/claude-api/SKILL.md Install the Anthropic TypeScript SDK using npm. This is required before using any TypeScript code examples. ```bash npm install @anthropic-ai/sdk ``` -------------------------------- ### Initialize Chroma Vector Store (Local) Source: https://github.com/codewithbehnam/cc-docs/blob/main/skills/ai-ml/rag-implementation/SKILL.md Demonstrates setting up a local Chroma vector store for development purposes. ```python from langchain_chroma import Chroma vectorstore = Chroma( collection_name="my_collection", embedding_function=embeddings, persist_directory="./chroma_db" ) ``` -------------------------------- ### Install Python SDK Source: https://github.com/codewithbehnam/cc-docs/blob/main/skills/ai-ml/claude-api/SKILL.md Install the Anthropic Python SDK using pip. This is required before using any Python code examples. ```bash pip install anthropic ``` -------------------------------- ### Conductor Setup Completion Summary Source: https://github.com/codewithbehnam/cc-docs/blob/main/commands/git-workflow/conductor-setup.md This is a sample output summarizing the successful completion of Conductor setup. It lists the artifacts created and suggests next steps for the user. ```text Conductor setup complete! Created artifacts: - conductor/index.md - conductor/product.md - conductor/product-guidelines.md - conductor/tech-stack.md - conductor/workflow.md - conductor/tracks.md - conductor/code_styleguides/[languages] Next steps: 1. Review generated files and customize as needed 2. Run /conductor:new-track to create your first track ``` -------------------------------- ### Install gh CLI Source: https://github.com/codewithbehnam/cc-docs/blob/main/claude-code-docs/claude-code-on-the-web.md Install the GitHub CLI if commands beyond the built-in tools are needed. Add this to your setup script. ```bash apt update && apt install -y gh ``` -------------------------------- ### Complete settings.json Example Source: https://github.com/codewithbehnam/cc-docs/blob/main/templates/cloud-providers/GCP-VERTEX-SETUP.md A comprehensive example of the settings.json file including Vertex AI and model configuration. ```json { "env": { "CLAUDE_CODE_USE_VERTEX": "1", "CLOUD_ML_REGION": "global", "ANTHROPIC_VERTEX_PROJECT_ID": "your-gcp-project-id", "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-4-6", "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-4-6", "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4-5@20251001" } } ``` -------------------------------- ### Prompt Guidance Example: Importance Rating Source: https://github.com/codewithbehnam/cc-docs/blob/main/skills/ai-ml/agent-native-architecture/references/refactoring-to-prompt-native.md Example of refining a prompt to guide an agent's decision-making, making it more conservative. ```markdown // Before Rate importance 1-5. // After (if agent keeps rating too high) Rate importance 1-5. Be conservative—most feedback is 2-3. Only use 4-5 for truly blocking or critical issues. ``` -------------------------------- ### Navigate to Tutorials Repository Source: https://github.com/codewithbehnam/cc-docs/blob/main/commands/development/sync-tutorials.md Change the current directory to the coding tutor tutorials repository. ```bash cd ~/coding-tutor-tutorials ``` -------------------------------- ### Start Claude Code and Request Component Source: https://github.com/codewithbehnam/cc-docs/blob/main/commands/documentation/create-blog-article.md Command to start the Claude Code environment and a prompt example to invoke a specific component. ```bash # Start Claude Code claude # Then write your prompt requesting the [type] > Use the [name] [type] to [example task] ``` -------------------------------- ### Testing Installation in Isolated Environment Source: https://github.com/codewithbehnam/cc-docs/blob/main/skills/language-specific/python-packaging/SKILL.md Demonstrates setting up a virtual environment, installing a built package, and testing its functionality and CLI. Includes steps for activation, installation, basic testing, and cleanup. ```bash # Create virtual environment python -m venv test-env source test-env/bin/activate # Linux/Mac # test-env\Scripts\activate # Windows # Install package pip install dist/my_package-1.0.0-py3-none-any.whl # Test it works python -c "import my_package; print(my_package.__version__)" # Test CLI my-tool --help # Cleanup deactivate rm -rf test-env ``` -------------------------------- ### Starting a New Project with UV Source: https://github.com/codewithbehnam/cc-docs/blob/main/skills/language-specific/uv-package-manager/SKILL.md Complete workflow for initializing a new project with UV, including setting Python versions, adding dependencies, and structuring the project. ```bash # Complete workflow uv init my-project cd my-project # Set Python version uv python pin 3.12 # Add dependencies uv add fastapi uvicorn pydantic # Add dev dependencies uv add --dev pytest black ruff mypy # Create structure mkdir -p src/my_project tests # Run tests uv run pytest # Format code uv run black . uv run ruff check . ``` -------------------------------- ### Install dmux Source: https://github.com/codewithbehnam/cc-docs/blob/main/skills/team-workflow/dmux-workflows/SKILL.md Install the dmux tool globally using npm. This command is required before you can start using dmux for agent orchestration. ```bash npm install -g dmux ``` -------------------------------- ### Clear vs. Ambiguous Instructions (XML Example) Source: https://github.com/codewithbehnam/cc-docs/blob/main/skills/productivity/create-agent-skills/references/be-clear-and-direct.md Illustrates how to rephrase ambiguous instructions into clear, actionable requirements using XML and bash. ```xml You should probably validate the output and try to fix any errors. ``` ```xml Always validate output before proceeding: ```bash python scripts/validate.py output_dir/ ``` If validation fails, fix errors and re-validate. Only proceed when validation passes with zero errors. ``` ```bash python scripts/validate.py output_dir/ ``` -------------------------------- ### Skills-less Operation Example Source: https://github.com/codewithbehnam/cc-docs/blob/main/skills/testing-quality/playwright-bowser/docs/playwright-cli.md An example of how a coding agent can interact with the Playwright CLI without explicit skill installation, by reading help commands. ```bash Test the "add todo" flow on https://demo.playwright.dev/todomvc using playwright-cli. Check playwright-cli --help for available commands. ``` -------------------------------- ### Global Setup and Teardown for All Tests Source: https://github.com/codewithbehnam/cc-docs/blob/main/skills/language-specific/bats-testing-patterns/SKILL.md Use `setup_file` to run expensive setup once before all tests and `teardown_file` to clean up after all tests are completed. This is ideal for shared resources. ```bash #!/usr/bin/env bats # Load shared setup from test_helper.sh load test_helper # setup_file runs once before all tests setup_file() { export SHARED_RESOURCE=$(mktemp -d) echo "Expensive setup" > "$SHARED_RESOURCE/data.txt" } # teardown_file runs once after all tests teardown_file() { rm -rf "$SHARED_RESOURCE" } @test "First test uses shared resource" { [ -f "$SHARED_RESOURCE/data.txt" ] } @test "Second test uses shared resource" { [ -d "$SHARED_RESOURCE" ] } ``` -------------------------------- ### Run Setup Hooks on Init Source: https://github.com/codewithbehnam/cc-docs/blob/main/claude-code-docs/cli-reference.md Execute Setup hooks with the `init` matcher before the session begins in print mode using the `--init` flag. ```bash claude -p --init "query" ``` -------------------------------- ### Rails Generator for Gem Installation Source: https://github.com/codewithbehnam/cc-docs/blob/main/skills/backend-development/andrew-kane-gem-writer/references/rails-integration.md An example of a Rails generator used to automate the installation process for a gem, including copying initializer and migration files. ```ruby # lib/generators/gemname/install_generator.rb module GemName module Generators class InstallGenerator < Rails::Generators::Base source_root File.expand_path("templates", __dir__) def copy_initializer template "initializer.rb", "config/initializers/gemname.rb" end def copy_migration migration_template "migration.rb", "db/migrate/create_gemname_tables.rb" end end end end ``` -------------------------------- ### Install My Full Plugin Source: https://github.com/codewithbehnam/cc-docs/blob/main/templates/plugins/PLUGIN-FULL.md Command to install the plugin from a GitHub repository. ```bash claude plugin install https://github.com/you/my-full-plugin ``` -------------------------------- ### Project Initialization and Dependency Management with UV Source: https://github.com/codewithbehnam/cc-docs/blob/main/skills/language-specific/uv-package-manager/SKILL.md Workflow for initializing a new project and adding dependencies using UV, offering faster performance. ```bash uv init uv add requests pandas uv sync ``` -------------------------------- ### Example Agent Installation Confirmation Source: https://github.com/codewithbehnam/cc-docs/blob/main/agents/meta-orchestration/agent-installer.md Confirms the successful installation of an agent to the specified directory. This message is shown to the user after the download and save operations are complete. ```Bash echo "✓ Installed python-pro.md to ~/.claude/agents/" ``` -------------------------------- ### Multi-file Skill SKILL.md Example Source: https://github.com/codewithbehnam/cc-docs/blob/main/skills/productivity/meta-skill/docs/claude_code_agent_skills.md The main SKILL.md file for a multi-file Skill, detailing its purpose, requirements, and providing quick start code examples. ```yaml --- name: PDF Processing description: Extract text, fill forms, merge PDFs. Use when working with PDF files, forms, or document extraction. Requires pypdf and pdfplumber packages. --- # PDF Processing ## Quick start Extract text: ```python import pdfplumber with pdfplumber.open("doc.pdf") as pdf: text = pdf.pages[0].extract_text() ``` For form filling, see [FORMS.md](FORMS.md). For detailed API reference, see [REFERENCE.md](REFERENCE.md). ## Requirements Packages must be installed in your environment: ```bash pip install pypdf pdfplumber ``` ``` -------------------------------- ### Conductor Setup with Existing Codebase Source: https://github.com/codewithbehnam/cc-docs/blob/main/skills/team-workflow/context-driven-development/SKILL.md Runs the setup process while detecting and analyzing an existing codebase for pre-populating context artifacts. ```bash /conductor:setup --existing-codebase ``` -------------------------------- ### Install from Official Marketplace Source: https://github.com/codewithbehnam/cc-docs/blob/main/cheatsheets/discover-plugins.md Use this command to install a plugin directly from the official Claude plugin marketplace. No additional setup is required for the official marketplace. ```shell /plugin install plugin-name@claude-plugins-official ``` -------------------------------- ### Example settings.json Configuration Source: https://github.com/codewithbehnam/cc-docs/blob/main/claude-code-docs/settings.md This example demonstrates a typical settings.json file, including permissions, environment variables, and company announcements. Adding the $schema line enables autocomplete and validation in supported editors. ```JSON { "$schema": "https://json.schemastore.org/claude-code-settings.json", "permissions": { "allow": [ "Bash(npm run lint)", "Bash(npm run test *)", "Read(~/.zshrc)" ], "deny": [ "Bash(curl *)", "Read(./.env)", "Read(./.env.*)", "Read(./secrets/**)" ] }, "env": { "CLAUDE_CODE_ENABLE_TELEMETRY": "1", "OTEL_METRICS_EXPORTER": "otlp" }, "companyAnnouncements": [ "Welcome to Acme Corp! Review our code guidelines at docs.acme.com", "Reminder: Code reviews required for all PRs", "New security policy in effect" ] } ``` -------------------------------- ### PDF Processing Skill Quick Start Source: https://github.com/codewithbehnam/cc-docs/blob/main/skills/productivity/create-agent-skills/references/best-practices.md Quick start example for PDF processing skill, demonstrating text extraction from a PDF file using pdfplumber. ```python import pdfplumber with pdfplumber.open("file.pdf") as pdf: text = pdf.pages[0].extract_text() ```