### Quick Start Example

Source: https://github.com/julianobarbosa/claude-code-skills/blob/main/templates/skill-template/SKILL.md

This is the most common usage pattern for the skill. It requires no specific setup beyond having the skill installed.

```python
# Example code or command
```

--------------------------------

### README Structure Example

Source: https://github.com/julianobarbosa/claude-code-skills/blob/main/skills/writing-python/References/code-style.md

A standard README file should include a project title, brief description, installation instructions, quick start guide, configuration details, and development setup.

```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
```
```

--------------------------------

### Complete Obsidian-nvim Setup Example

Source: https://github.com/julianobarbosa/claude-code-skills/blob/main/skills/obsidian-nvim/references/configuration.md

A comprehensive configuration example demonstrating workspaces, note settings, daily notes, templates, completion, UI, and logging.

```lua
require("obsidian").setup({
  workspaces = {
    { name = "personal", path = "~/vaults/personal" },
    { name = "work", path = "~/vaults/work" },
  },

  notes_subdir = "notes",
  new_notes_location = "notes_subdir",

  daily_notes = {
    folder = "daily",
    date_format = "%Y-%m-%d",
    alias_format = "%B %-d, %Y",
    template = "daily.md",
    default_tags = { "daily-notes" },
    workdays_only = true,
  },

  templates = {
    folder = "templates",
    date_format = "%Y-%m-%d",
    time_format = "%H:%M",
    substitutions = {},
  },

  frontmatter = {
    enabled = true,
    sort = { "id", "aliases", "tags" },
  },

  completion = {
    nvim_cmp = true,
    min_chars = 2,
  },

  picker = {
    name = "telescope",
    note_mappings = {
      new = "<C-x>",
      insert_link = "<C-l>",
    },
  },

  preferred_link_style = "wiki",
  open_notes_in = "current",

  ui = {
    enable = true,
    checkboxes = {
      [" "] = { char = "󰄱", hl_group = "ObsidianTodo" },
      ["x"] = { char = "", hl_group = "ObsidianDone" },
    },
  },

  log_level = vim.log.levels.INFO,
})
```

--------------------------------

### Quick Start Kargo Installation

Source: https://github.com/julianobarbosa/claude-code-skills/blob/main/skills/progressive-delivery/References/kargo.md

Installs Kargo quickly using a provided shell script from a GitHub repository. This is a convenient option for a fast setup.

```bash
curl -L https://raw.githubusercontent.com/akuity/kargo/main/hack/quickstart/install.sh | sh
```

--------------------------------

### Vault Setup Skill Examples

Source: https://github.com/julianobarbosa/claude-code-skills/blob/main/skills/vault-setup/SKILL.md

Provides example phrases for interacting with the vault setup skill.

```text
"Set up my Obsidian vault"              → Workflows/Setup.md
"I want to create a second brain"       → Workflows/Setup.md
"Import my documents into the vault"    → Workflows/ImportFiles.md
"Verify my vault is set up correctly"   → Workflows/Verify.md
"What plugins should I install?"        → PluginRecommendations.md
"Add this vault to my global config"    → Workflows/Setup.md Step 5
```

--------------------------------

### Install Go SDK

Source: https://github.com/julianobarbosa/claude-code-skills/blob/main/skills/pyroscope/references/sdk-instrumentation.md

Install the Pyroscope Go SDK using the go get command.

```bash
go get github.com/grafana/pyroscope-go
```

--------------------------------

### Development Workflow: Initial Setup

Source: https://github.com/julianobarbosa/claude-code-skills/blob/main/skills/uv/references/project-management.md

Perform the initial setup for a development environment using UV by synchronizing dependencies. This command ensures all project dependencies are installed.

```bash
uv sync
```

--------------------------------

### Basic Usage Example

Source: https://github.com/julianobarbosa/claude-code-skills/blob/main/templates/skill-template/SKILL.md

Demonstrates the basic command or code example for the skill. This is a straightforward way to get started.

```bash
# Command or code example
```

--------------------------------

### Pre-commit Hooks Installation and Usage

Source: https://github.com/julianobarbosa/claude-code-skills/blob/main/Plans/we-need-your-assistance-eager-catmull.md

Instructions for installing and running pre-commit hooks. This includes one-time setup and manual execution commands.

```bash
pipx install pre-commit          # or: brew install pre-commit
pre-commit install --install-hooks
```

```bash
pre-commit run --all-files
```

```bash
pre-commit run shellcheck --all-files
```

--------------------------------

### Install using Kubernetes Manifests

Source: https://github.com/julianobarbosa/claude-code-skills/blob/main/skills/argocd-advanced/References/image-updater/installation.md

Apply the official installation manifest directly to the 'argocd' namespace for a quick setup.

```bash
kubectl apply -n argocd -f https://raw.githubusercontent.com/argoproj-labs/argocd-image-updater/stable/config/install.yaml
```

--------------------------------

### Full ArgoCD Project Setup

Source: https://github.com/julianobarbosa/claude-code-skills/blob/main/skills/argocd/References/command-workflows/ProjectManage.md

A comprehensive example demonstrating the creation of an ArgoCD project with a description, adding multiple source repositories, defining allowed destinations, and configuring cluster and namespace resource access.

```bash
argocd proj create platform-team --description "Platform team applications"
```

```bash
argocd proj add-source platform-team https://github.com/org/platform-apps.git
```

```bash
argocd proj add-source platform-team https://charts.bitnami.com/bitnami
```

```bash
argocd proj add-destination platform-team https://kubernetes.default.svc monitoring
```

```bash
argocd proj add-destination platform-team https://kubernetes.default.svc logging
```

```bash
argocd proj add-destination platform-team '*' '*'
```

```bash
argocd proj allow-cluster-resource platform-team '*' '*'
```

```bash
argocd proj allow-namespace-resource platform-team '*' '*'
```

--------------------------------

### Existing Project Setup from requirements.txt with UV

Source: https://github.com/julianobarbosa/claude-code-skills/blob/main/skills/uv/SKILL.md

Initialize a UV project in an existing project and import dependencies from a requirements.txt file. Alternatively, use the pip interface for installation.

```bash
# Initialize uv project
uv init

# Import dependencies from requirements.txt
uv add $(cat requirements.txt | grep -v "^#" | tr '\n' ' ')

# Or use pip interface
uv venv
uv pip install -r requirements.txt
```

--------------------------------

### Apply a Preset

Source: https://github.com/julianobarbosa/claude-code-skills/blob/main/skills/macos-setup/presets.md

Installs macOS setup using a specified preset (e.g., 'fullstack').

```bash
# Use a preset
/new-macos-setup --preset fullstack
```

--------------------------------

### Go Sentry SDK Installation

Source: https://github.com/julianobarbosa/claude-code-skills/blob/main/skills/sentry/SKILL.md

Install the Sentry SDK for Go applications using go get. This command fetches the necessary package.

```bash
go get github.com/getsentry/sentry-go
```

--------------------------------

### Clone and Set Up Sample Obsidian Plugin

Source: https://github.com/julianobarbosa/claude-code-skills/blob/main/skills/obsidian/references/plugin-development.md

Use these commands to clone a sample plugin repository, navigate into its directory, install necessary dependencies, and build the plugin for initial setup.

```bash
# Clone sample plugin
git clone https://github.com/obsidianmd/obsidian-sample-plugin.git my-plugin
cd my-plugin

# Install dependencies
npm install

# Build plugin
npm run build

# Development with hot reload
npm run dev
```

--------------------------------

### Initial Setup for New Users

Source: https://github.com/julianobarbosa/claude-code-skills/blob/main/skills/az-aks-agent/references/examples.md

Follow these steps to install the AKS Agent extension, log in to Azure, and initialize the agent for the first time. Ensure your Azure CLI version is 2.76 or higher.

```bash
# Step 1: Verify Azure CLI version (must be 2.76+)
az version

# Step 2: Install the AKS Agent extension
az extension add --name aks-agent --debug

# Step 3: Login to Azure
az login

# Step 4: Set your subscription
az account set --subscription "My AKS Subscription"

# Step 5: Initialize LLM configuration
az aks agent-init

# Step 6: Get cluster credentials
az aks get-credentials \
  --resource-group cafehyna-rg \
  --name cafehyna-dev

# Step 7: Verify connection
kubectl get nodes

# Step 8: Start using the agent
az aks agent -g cafehyna-rg -n cafehyna-dev
```

--------------------------------

### Example: Verify Existing Vault

Source: https://github.com/julianobarbosa/claude-code-skills/blob/main/skills/vault-setup/Tools/VaultBuilder.help.md

Demonstrates how to verify the setup of an existing Obsidian vault located at a specified path.

```bash
# Verify an existing vault
python Tools/VaultBuilder.py verify --vault-path ~/vaults/work
```

--------------------------------

### Basic GitHub Actions CI Setup with UV

Source: https://github.com/julianobarbosa/claude-code-skills/blob/main/skills/uv/references/integrations.md

Sets up a GitHub Actions workflow to run CI tests using UV for dependency management. Includes checkout, UV installation, Python setup, dependency synchronization, and test execution.

```yaml
name: CI

on: [push, pull_request]

jobs:
  test:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v5

      - name: Install uv
        uses: astral-sh/setup-uv@v7

      - name: Set up Python
        run: uv python install

      - name: Install dependencies
        run: uv sync --locked

      - name: Run tests
        run: uv run pytest
```

--------------------------------

### Docker Image Setup with UV

Source: https://github.com/julianobarbosa/claude-code-skills/blob/main/skills/uv/SKILL.md

Create a Docker image using a Python base image and UV for dependency installation. Includes caching for dependencies and project installation.

```dockerfile
FROM python:3.12-slim
COPY --from=ghcr.io/astral-sh/uv:latest /uv /uvx /bin/

WORKDIR /app
COPY pyproject.toml uv.lock ./

# Install dependencies only (for caching)
RUN --mount=type=cache,target=/root/.cache/uv \
    uv sync --locked --no-install-project

# Copy source and install project
COPY . .
RUN --mount=type=cache,target=/root/.cache/uv \
    uv sync --locked

ENV PATH="/app/.venv/bin:$PATH"
CMD ["python", "-m", "my_app"]
```

--------------------------------

### Vitest Configuration Example

Source: https://github.com/julianobarbosa/claude-code-skills/blob/main/skills/writing-typescript/TESTING.md

Configure Vitest with options for globals, environment, setup files, and coverage reporters/exclusions.

```typescript
import { defineConfig } from "vitest/config";

export default defineConfig({
  test: {
    globals: true,
    environment: "jsdom",
    setupFiles: ["./tests/setup.ts"],
    coverage: {
      reporter: ["text", "html"],
      exclude: ["node_modules/", "tests/"],
    },
  },
});
```

--------------------------------

### Execute macOS Setup Plan with Progress Tracking

Source: https://github.com/julianobarbosa/claude-code-skills/blob/main/skills/macos-setup/SKILL.md

A bash script to automate the execution of the macOS setup plan. It includes functions for phase execution and conditional installation of tools with progress indicators.

```bash
# Example execution with progress
execute_phase() {
    local phase=$1
    echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
    echo "📦 Phase $phase"
    echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
}

# Phase 1: CLI Tools
execute_phase "1: CLI Tools"
brew install git gh delta starship
brew install eza bat fd ripgrep sd dust procs bottom
brew install tree wget curl jq yq

# Phase 2: Languages
execute_phase "2: Language Environments"
brew install fnm uv goenv go
fnm install --lts
fnm default lts-latest
npm install -g pnpm

# Phase 3: Apps
execute_phase "3: Applications"
brew install --cask raycast warp orbstack

# Phase 4: Vibe Coding (with skip detection)
execute_phase "4: Vibe Coding Tools"

# Claude Code
if ! command -v claude &>/dev/null; then
    echo "📦 Installing Claude Code..."
    brew install --cask claude-code
else
    echo "⏭️  Claude Code already installed, skipping"
fi

# CCometixLine (requires Node.js)
if ! command -v ccline &>/dev/null; then
    if command -v npm &>/dev/null; then
        echo "📦 Installing CCometixLine..."
        npm install -g @cometix/ccline
        echo "💡 Configure: Add to ~/.claude/settings.json:"
        echo '   {"statusLine": {"type": "command", "command": "ccline"}}'
    else
        echo "⚠️  CCometixLine requires Node.js, install fnm/node first"
    fi
else
    echo "⏭️  CCometixLine already installed, skipping"
fi

# Cursor
if [ ! -d "/Applications/Cursor.app" ]; then
    echo "📦 Installing Cursor..."
    brew install --cask cursor
else
    echo "⏭️  Cursor already installed, skipping"
fi

# OpenCode
if ! command -v opencode &>/dev/null; then
    echo "📦 Installing OpenCode..."
    brew install opencode
else
    echo "⏭️  OpenCode already installed, skipping"
fi

# Cherry Studio
if [ ! -d "/Applications/Cherry Studio.app" ]; then
    echo "📦 Installing Cherry Studio..."
    brew install --cask cherry-studio
else
    echo "⏭️  Cherry Studio already installed, skipping"
fi

# Phase 5: Fonts
execute_phase "5: Fonts"
brew install --cask font-jetbrains-mono-nerd-font
brew install --cask font-fira-code font-inter

# Phase 6: Shell
execute_phase "6: Shell Configuration"
# Install zsh plugins...
# Configure starship...

# Phase 7: macOS
execute_phase "7: macOS Optimization"
defaults write com.apple.dock show-recents -bool false
defaults write NSGlobalDomain KeyRepeat -int 2
# ...

echo "✅ Setup complete!"

```

--------------------------------

### Install Atuin using Official Installer

Source: https://github.com/julianobarbosa/claude-code-skills/blob/main/skills/atuin/SKILL.md

Use the official installer script for a recommended installation of Atuin.

```bash
curl --proto '=https' --tlsv1.2 -LsSf https://setup.atuin.sh | sh
```

--------------------------------

### Example Wiki Directory Structure

Source: https://github.com/julianobarbosa/claude-code-skills/blob/main/skills/azure-devops-wiki/references/best-practices.md

Illustrates a recommended hierarchical structure for organizing wiki content, starting from the root and branching into sections like Getting Started, User Guide, API Reference, and Troubleshooting.

```markdown
Wiki Root
├── Home (Welcome + navigation)
├── Getting Started/
│   ├── Prerequisites
│   ├── Installation
│   ├── Quick Start
│   └── First Steps
├── User Guide/
│   ├── Core Concepts
│   ├── Common Tasks
│   └── Advanced Usage
├── API Reference/
│   ├── Overview
│   ├── Authentication
│   └── Endpoints
├── Troubleshooting/
│   ├── Common Issues
│   └── FAQ
└── Contributing
```

--------------------------------

### Step 1: Run Query Command Example

Source: https://github.com/julianobarbosa/claude-code-skills/blob/main/skills/context7/Workflows/QueryDocs.md

An example of running the query command with placeholder values for library ID and query.

```bash
c7-query "/org/project" "specific question"
```

--------------------------------

### New Project Setup with UV

Source: https://github.com/julianobarbosa/claude-code-skills/blob/main/skills/uv/SKILL.md

Initialize a new project, add dependencies (application and development), and run applications or tests using UV commands.

```bash
# Create and enter project
uv init my-project
cd my-project

# Add dependencies
uv add flask sqlalchemy
uv add --dev pytest ruff mypy

# Run application
uv run flask run

# Run tests
uv run pytest
```

--------------------------------

### Prometheus Range Query Example

Source: https://github.com/julianobarbosa/claude-code-skills/blob/main/skills/prometheus/SKILL.md

Use this command for range queries to get data over a period. Specify the Prometheus URL, PromQL query, start and end timestamps, and the step duration.

```bash
curl 'http://<prometheus>:9090/api/v1/query_range?query=<promql>&start=<ts>&end=<ts>&step=<duration>'
```

--------------------------------

### Preview Preset Installation

Source: https://github.com/julianobarbosa/claude-code-skills/blob/main/skills/macos-setup/presets.md

Simulates the installation of a preset (e.g., 'backend') without making any actual changes to the system.

```bash
# Preview preset without installing
/new-macos-setup --preset backend --dry-run
```

--------------------------------

### Obsidian REST API Quick Start

Source: https://github.com/julianobarbosa/claude-code-skills/blob/main/skills/obsidian/References/master.md

Provides a bash example for interacting with the Obsidian REST API, including setting environment variables for authentication and making a basic vault query.

```bash
# Requires Local REST API plugin enabled in Obsidian
export OBSIDIAN_API_KEY="your-key"
export OBSIDIAN_BASE_URL="https://127.0.0.1:27124"

curl -H "Authorization: Bearer $OBSIDIAN_API_KEY" $OBSIDIAN_BASE_URL/vault/
```

--------------------------------

### Get Folder Example Response

Source: https://github.com/julianobarbosa/claude-code-skills/blob/main/skills/grafana/references/folders.md

Example JSON response when retrieving a single folder.

```json
{
  "id": 1,
  "uid": "nErXDvCkzz",
  "title": "Operations",
  "url": "/dashboards/f/nErXDvCkzz/operations",
  "hasAcl": false,
  "canSave": true,
  "canEdit": true,
  "canAdmin": true,
  "canDelete": true,
  "createdBy": "admin",
  "created": "2023-01-15T10:30:00Z",
  "updatedBy": "admin",
  "updated": "2024-06-20T14:22:00Z",
  "version": 3,
  "parentUid": ""
}
```

--------------------------------

### Install Go Development Environment

Source: https://github.com/julianobarbosa/claude-code-skills/blob/main/skills/macos-setup/presets.md

Sets up Go using goenv, installs the latest stable Go version, and configures it as the global default.

```bash
# Go
brew install goenv go
# Install latest stable Go version
LATEST_GO=$(goenv install -l | grep -E '^\s*[0-9]+\.[0-9]+\.[0-9]+$' | tail -1 | tr -d ' ')
goenv install "$LATEST_GO"
goenv global "$LATEST_GO"
```

--------------------------------

### Setup Playwright and Chromium

Source: https://github.com/julianobarbosa/claude-code-skills/blob/main/skills/playwright/SKILL.md

Installs Playwright and the Chromium browser. This command is only needed once for initial setup.

```bash
cd $SKILL_DIR
npm run setup
```

--------------------------------

### Create New MkDocs Project and Start Server

Source: https://github.com/julianobarbosa/claude-code-skills/blob/main/skills/mkdocs/SKILL.md

Create a new MkDocs project structure, navigate into it, and start the development server.

```bash
# Create project structure
mkdocs new my-project
cd my-project

# Start development server
mkdocs serve
```

--------------------------------

### Get Current User API Response Example

Source: https://github.com/julianobarbosa/claude-code-skills/blob/main/skills/grafana/references/UsersTeams.md

Example JSON response for the 'Get Current User' API endpoint, detailing user properties like ID, email, name, and administrative status.

```json
{
  "id": 1,
  "email": "admin@example.com",
  "name": "Admin User",
  "login": "admin",
  "theme": "dark",
  "orgId": 1,
  "isGrafanaAdmin": true,
  "isDisabled": false,
  "isExternal": false,
  "authLabels": [],
  "updatedAt": "2024-06-20T14:22:00Z",
  "createdAt": "2023-01-15T10:30:00Z",
  "avatarUrl": "/avatar/46d229b033af06a191ff2267bca9ae56"
}
```

--------------------------------

### Quick Setup for GitHub Plugin

Source: https://github.com/julianobarbosa/claude-code-skills/blob/main/skills/1password/SKILL.md

Run the setup script for a streamlined configuration of 1Password with GitHub.

```bash
./scripts/setup-gh-plugin.sh
```

--------------------------------

### Capture a How-To Note

Source: https://github.com/julianobarbosa/claude-code-skills/blob/main/skills/obsidian/References/master-workflows/CaptureKnowledge.md

Use this command to capture a new how-to guide. Specify the type, title, content, and relevant tags.

```bash
python Tools/NoteCreator.py capture \
  --type howto \
  --title "Deploy to Kubernetes with Helm" \
  --content "Prerequisites: kubectl, helm..." \
  --tags "howto,kubernetes,helm"
```

--------------------------------

### Node.js/JavaScript Auto-instrumentation Setup

Source: https://github.com/julianobarbosa/claude-code-skills/blob/main/skills/opentelemetry/references/INSTRUMENTATION.md

Configure and start the OpenTelemetry Node.js SDK for auto-instrumentation. This script should be loaded before the application starts.

```javascript
// tracing.js - load before app
const { NodeSDK } = require('@opentelemetry/sdk-node');
const { getNodeAutoInstrumentations } = require('@opentelemetry/auto-instrumentations-node');
const { OTLPTraceExporter } = require('@opentelemetry/exporter-trace-otlp-grpc');

const sdk = new NodeSDK({
  traceExporter: new OTLPTraceExporter({
    url: process.env.OTEL_EXPORTER_OTLP_ENDPOINT || 'http://otel-collector:4317',
  }),
  instrumentations: [getNodeAutoInstrumentations()],
});

sdk.start();
```

--------------------------------

### Install and Run Mockery

Source: https://github.com/julianobarbosa/claude-code-skills/blob/main/skills/writing-go/TESTING.md

Installs the mockery tool and demonstrates its basic usage for generating mock interfaces.

```bash
go install github.com/vektra/mockery/v2@latest

mockery --all --keeptree
mockery --name=UserStore --dir=internal/service
```

--------------------------------

### Install Standalone Robusta

Source: https://github.com/julianobarbosa/claude-code-skills/blob/main/skills/robusta-dev/Workflows/Install.md

Installs Robusta using Helm without the Prometheus stack, assuming an existing Prometheus setup.

```bash
helm install robusta robusta/robusta \
  -f ./generated_values.yaml \
  --set clusterName=my-cluster
```

--------------------------------

### Install MarkItDown MCP Server

Source: https://github.com/julianobarbosa/claude-code-skills/blob/main/skills/markitdown/references/advanced-features.md

Install the MarkItDown MCP server using pip. This command is used for initial setup.

```bash
pip install markitdown-mcp
```

--------------------------------

### Create Table and Partitions

Source: https://github.com/julianobarbosa/claude-code-skills/blob/main/skills/power-bi-partitions/SKILL.md

This workflow demonstrates creating a new table and then setting up partitions for specific date ranges. Partitions allow for granular data management and refresh.

```bash
# 1. Create a table
pbi table create Sales --mode Import

# 2. Create partitions for different date ranges
pbi partition create "Sales_2023" --table Sales \
  --expression "let Source = ... in Filtered2023" \
  --mode Import

pbi partition create "Sales_2024" --table Sales \
  --expression "let Source = ... in Filtered2024" \
  --mode Import
```

--------------------------------

### Install and Verify MkDocs

Source: https://github.com/julianobarbosa/claude-code-skills/blob/main/skills/mkdocs/SKILL.md

Install MkDocs using pip and verify the installation by checking the version.

```bash
# Install MkDocs
pip install mkdocs

# Verify installation
mkdocs --version
```

--------------------------------

### Packaging an MkDocs Plugin with setup.py

Source: https://github.com/julianobarbosa/claude-code-skills/blob/main/skills/mkdocs/references/plugins.md

Use this setup.py to define your MkDocs plugin, specify dependencies, and register the plugin's entry point.

```python
from setuptools import setup, find_packages

setup(
    name='mkdocs-myplugin',
    version='1.0.0',
    packages=find_packages(),
    install_requires=['mkdocs>=1.0'],
    entry_points={
        'mkdocs.plugins': [
            'myplugin = mkdocs_myplugin.plugin:MyPlugin',
        ]
    },
    python_requires='>=3.8',
)
```

--------------------------------

### Complete MkDocs Configuration Example

Source: https://github.com/julianobarbosa/claude-code-skills/blob/main/skills/mkdocs/references/configuration.md

A comprehensive example showcasing various MkDocs configuration options, including site metadata, repository settings, navigation structure, theme customization, extensions, and plugins.

```yaml
site_name: My Project
site_url: https://docs.example.com/
site_description: Project documentation
site_author: John Doe
copyright: Copyright 2024 Example Inc.

repo_url: https://github.com/example/project
repo_name: GitHub
edit_uri: edit/main/docs/

docs_dir: docs
site_dir: build

nav:
  - Home: index.md
  - Getting Started:
    - Installation: getting-started/installation.md
    - Quick Start: getting-started/quickstart.md
  - User Guide:
    - Configuration: user-guide/configuration.md
    - Advanced: user-guide/advanced.md
  - API Reference: api/
  - Changelog: changelog.md
  - GitHub: https://github.com/example/project

theme:
  name: material
  palette:
    primary: indigo
  features:
    - navigation.tabs
    - search.suggest
  custom_dir: overrides/

extra_css:
  - stylesheets/extra.css

extra_javascript:
  - scripts/extra.js

markdown_extensions:
  - toc:
      permalink: true
  - admonition
  - pymdownx.highlight
  - pymdownx.superfences
  - pymdownx.tabbed:
      alternate_style: true

plugins:
  - search:
      lang: en
  - tags

validation:
  nav:
    omitted_files: warn
  links:
    not_found: warn

extra:
  version: !ENV [VERSION, 'dev']
  analytics:
    provider: google
    property: G-XXXXXXXXXX
```

--------------------------------

### Get Team Members API Response Example

Source: https://github.com/julianobarbosa/claude-code-skills/blob/main/skills/grafana/references/UsersTeams.md

Example JSON response for a team's members, including user details and permissions.

```json
[
  {
    "orgId": 1,
    "teamId": 1,
    "userId": 2,
    "email": "user@example.com",
    "name": "User Name",
    "login": "username",
    "avatarUrl": "/avatar/46d229b033af06a191ff2267bca9ae56",
    "labels": [],
    "permission": 0
  }
]
```

--------------------------------

### Get Label Values API

Source: https://github.com/julianobarbosa/claude-code-skills/blob/main/skills/prometheus/references/api_reference.md

Retrieve values for a specific label. Supports GET requests with optional start, end, match, and limit parameters.

```bash
curl 'http://localhost:9090/api/v1/label/job/values'
# Returns: ["prometheus", "node", "alertmanager"]
```

--------------------------------

### Date Functions Examples

Source: https://github.com/julianobarbosa/claude-code-skills/blob/main/skills/obsidian-vault-management/references/dataview.md

Provides examples of Dataview date functions for getting current dates/times, specific dates, durations, and extracting date components.

```dataview
date(today)                      # Today
```

```dataview
date(now)                        # Current datetime
```

```dataview
date(tomorrow)                   # Tomorrow
```

```dataview
date(yesterday)                  # Yesterday
```

```dataview
date("2025-12-09")               # Specific date
```

```dataview
dur(7 days)                      # Duration
```

```dataview
dur(1 week)                      # Duration
```

```dataview
file.cday.year                   # Extract year
```

```dataview
file.cday.month                  # Extract month
```

```dataview
file.cday.day                    # Extract day
```

--------------------------------

### Get Prometheus Flags

Source: https://github.com/julianobarbosa/claude-code-skills/blob/main/skills/prometheus/SKILL.md

Retrieves the command-line flags Prometheus was started with.

```APIDOC
## GET /api/v1/status/flags

### Description
Returns the command-line flags used when starting Prometheus.

### Method
GET

### Endpoint
`/api/v1/status/flags`
```

--------------------------------

### Setup Project GitHub Pages Site

Source: https://github.com/julianobarbosa/claude-code-skills/blob/main/skills/github-pages/SKILL.md

This setup is for a Project site. Any repository can be used, multiple project sites are allowed, and the URL includes the repository name. Choose between a branch (root or /docs) or GitHub Actions for deployment.

```bash
# Any repository works
# Enable Pages in Settings > Pages
# Choose: branch (root or /docs) OR GitHub Actions
```

--------------------------------

### Example: Get Password for a Credential

Source: https://github.com/julianobarbosa/claude-code-skills/blob/main/skills/senhasegura/References/McpIntegration.md

Shows the process of retrieving a password for a specific credential, including the calls to list and get the password, and automatic custody release.

```text
You: Get the password for the production database credential
Claude: [calls senhasegura_list_credentials → finds db-admin-prod]
        [calls senhasegura_get_password with credentialId]
        The password for db-admin-prod has been retrieved.
        Custody released automatically.
```

--------------------------------

### Install LSP Servers via Mason

Source: https://github.com/julianobarbosa/claude-code-skills/blob/main/skills/neovim/references/lsp.md

Use the Mason command to interactively search and install LSP servers.

```vim
:Mason
```

--------------------------------

### Get All Label Names API

Source: https://github.com/julianobarbosa/claude-code-skills/blob/main/skills/prometheus/references/api_reference.md

Retrieve all available label names. Supports GET and POST requests with optional start, end, match, and limit parameters.

```bash
curl 'http://localhost:9090/api/v1/labels'
# Returns: ["__name__", "instance", "job", ...]
```

--------------------------------

### Context7Client Initialization and Usage

Source: https://github.com/julianobarbosa/claude-code-skills/blob/main/skills/context7/SKILL.md

Demonstrates how to import and initialize the Context7Client, set logging levels, and perform documentation lookups with caching.

```APIDOC
## Class: Context7Client

### Description
Provides methods to interact with the Context7 API for documentation retrieval.

### Methods

#### `queryDocs(cached: string, query: string): Promise<any>`

##### Description
Queries documentation based on cached library ID and a specific query.

##### Parameters

- **cached** (string) - Required - The cached library ID.
- **query** (string) - Required - The documentation query string.

##### Request Example
```typescript
const docs = await client.queryDocs(cached, "useEffect cleanup");
console.log(docs.rawContent);
```

#### `lookup(libraryName: string, query: string): Promise<any>`

##### Description
Looks up documentation for a given library name and query.

##### Parameters

- **libraryName** (string) - Required - The name of the library.
- **query** (string) - Required - The documentation query string.

##### Request Example
```typescript
const result = await client.lookup("react", "useEffect hooks");
if (result.library) await setCached("react", result.library.id);
console.log(result.rawContent);
```

## Utility Functions

#### `setLogLevel(level: string): void`

##### Description
Sets the logging level for the client.

##### Parameters

- **level** (string) - Required - The desired log level (e.g., "warn").

#### `getCached(key: string, ttl: number): Promise<string | null>`

##### Description
Retrieves a cached item by its key, with a Time To Live (TTL).

##### Parameters

- **key** (string) - Required - The cache key.
- **ttl** (number) - Required - The time to live in milliseconds.

#### `setCached(key: string, value: string): Promise<void>`

##### Description
Sets a value in the cache with a given key.

##### Parameters

- **key** (string) - Required - The cache key.
- **value** (string) - Required - The value to cache.

#### `getKnownLibraryId(libraryName: string): Promise<string | null>`

##### Description
Retrieves the known ID for a given library name.

##### Parameters

- **libraryName** (string) - Required - The name of the library.

```

--------------------------------

### Install onepassword-sdk

Source: https://github.com/julianobarbosa/claude-code-skills/blob/main/skills/1password/references/python-sdk.md

Install the SDK using uv or pip. uv is the recommended package manager.

```bash
# With uv (recommended)
uv add onepassword-sdk

# With pip
pip install onepassword-sdk
```

--------------------------------

### Install Atuin on Secondary Machine

Source: https://github.com/julianobarbosa/claude-code-skills/blob/main/skills/atuin/references/workflows.md

Install Atuin on a secondary machine using a curl script. This is a quick way to get Atuin set up on a new system.

```bash
# Install Atuin
curl --proto '=https' --tlsv1.2 -LsSf https://setup.atuin.sh | sh
```

--------------------------------

### Example AKS Node Auto-Repair Event Messages

Source: https://github.com/julianobarbosa/claude-code-skills/blob/main/skills/az-aks-agent/references/node-auto-repair.md

These examples show the typical messages for start, end, and error events generated by the AKS node auto-repair system.

```bash
# Start Event
Node auto-repair is initiating a reboot action due to NotReady status persisting for more than 5 minutes.

# End Event
Reboot action from node auto-repair is completed.

# Error Event
Node auto-repair reboot action failed due to an operation failure. See error details: [Error code]
```

--------------------------------

### Kubernetes Deployments Query Example

Source: https://github.com/julianobarbosa/claude-code-skills/blob/main/skills/context7/Workflows/QueryDocs.md

Example query for Kubernetes deployments, specifically asking about rolling update strategies and surge parameters.

```bash
c7-query /kubernetes/kubernetes "deployment strategy rolling update maxSurge"
```

--------------------------------

### Start Neovim with Minimal Configuration

Source: https://github.com/julianobarbosa/claude-code-skills/blob/main/skills/neovim/references/troubleshooting.md

Use the `--clean` flag to start Neovim without loading any user configuration or plugins, useful for isolating startup issues.

```bash
nvim --clean
```

--------------------------------

### Initialize a new project with uv init

Source: https://github.com/julianobarbosa/claude-code-skills/blob/main/skills/uv/references/cli-commands.md

Use `uv init` to create a new project. Specify project type, Python version, and VCS.

```bash
uv init my-project
```

```bash
uv init --lib my-library
```

```bash
uv init --app --python 3.12 my-app
```

```bash
uv init --script example.py
```

--------------------------------

### Install Robusta Standalone via Helm

Source: https://github.com/julianobarbosa/claude-code-skills/blob/main/skills/robusta-dev/SKILL.md

Installs Robusta in a standalone mode using Helm, assuming an existing Prometheus setup. Requires a generated configuration file.

```bash
helm install robusta robusta/robusta -f ./generated_values.yaml
```

--------------------------------

### Install and Setup git-secrets

Source: https://github.com/julianobarbosa/claude-code-skills/blob/main/skills/git/references/SecurityChecklist.md

Installs and configures git-secrets, a tool that scans commits, push operations, and existing commits for secrets. It's particularly useful for AWS environments.

```bash
# Install
brew install git-secrets

# Setup
git secrets --install
git secrets --register-aws

```

--------------------------------

### Initialize uv Project

Source: https://github.com/julianobarbosa/claude-code-skills/blob/main/skills/uv/References/python-project-references/uv-commands.md

Initializes a new project with uv. Use --lib for library projects and --app for application projects.

```bash
# Initialize
uv init <name>                    # Create new project
uv init --lib <name>              # Create library project
uv init --app <name>              # Create application project
```

--------------------------------

### Using setup-python with UV in GitHub Actions

Source: https://github.com/julianobarbosa/claude-code-skills/blob/main/skills/uv/references/integrations.md

Combines `actions/setup-python` with `astral-sh/setup-uv` for potentially faster Python environment setup in GitHub Actions. Enables caching for UV.

```yaml
- uses: actions/setup-python@v6
  with:
    python-version-file: ".python-version"

- uses: astral-sh/setup-uv@v7
  with:
    enable-cache: true
```

--------------------------------

### Python Dependency Injection Example

Source: https://github.com/julianobarbosa/claude-code-skills/blob/main/skills/python-design-patterns/SKILL.md

Shows how to implement dependency injection in a Python class by passing dependencies (like logger and cache) through the constructor. Includes examples for both production and testing setups.

```python
from typing import Protocol

class Logger(Protocol):
    def info(self, msg: str, **kwargs) -> None: ...
    def error(self, msg: str, **kwargs) -> None: ...

class Cache(Protocol):
    async def get(self, key: str) -> str | None: ...
    async def set(self, key: str, value: str, ttl: int) -> None: ...

class UserService:
    """Service with injected dependencies."""

    def __init__(
        self,
        repository: UserRepository,
        cache: Cache,
        logger: Logger,
    ) -> None:
        self._repo = repository
        self._cache = cache
        self._logger = logger

    async def get_user(self, user_id: str) -> User:
        # Check cache first
        cached = await self._cache.get(f"user:{user_id}")
        if cached:
            self._logger.info("Cache hit", user_id=user_id)
            return User.from_json(cached)

        # Fetch from database
        user = await self._repo.get_by_id(user_id)
        if user:
            await self._cache.set(f"user:{user_id}", user.to_json(), ttl=300)

        return user

# Production
service = UserService(
    repository=PostgresUserRepository(db),
    cache=RedisCache(redis),
    logger=StructlogLogger(),
)

# Testing
service = UserService(
    repository=InMemoryUserRepository(),
    cache=FakeCache(),
    logger=NullLogger(),
)
```

--------------------------------

### GET /api/v1/status/runtimeinfo

Source: https://github.com/julianobarbosa/claude-code-skills/blob/main/skills/prometheus/references/api_reference.md

Retrieves runtime properties of the Prometheus server, such as start time and goroutine count.

```APIDOC
## GET /api/v1/status/runtimeinfo

### Description
Returns runtime properties (startTime, goroutineCount, storageRetention, etc).

### Method
GET

### Endpoint
/api/v1/status/runtimeinfo
```

--------------------------------

### Setup 1Password Python Tools

Source: https://github.com/julianobarbosa/claude-code-skills/blob/main/skills/1password/tools-python/README.md

Navigate to the tools-python directory and synchronize dependencies using uv.

```bash
cd tools-python
uv sync
```

--------------------------------

### Install LSP Server with Mason

Source: https://github.com/julianobarbosa/claude-code-skills/blob/main/skills/neovim/references/troubleshooting.md

Use the `:Mason` command to manage LSP servers and other development tools. This snippet shows how to search and install a missing server.

```vim
:Mason
" Search and install the server
```

--------------------------------

### Install Jekyll Dependencies and Serve Locally

Source: https://github.com/julianobarbosa/claude-code-skills/blob/main/skills/github-pages/workflows/JekyllSetup.md

Install project dependencies using Bundler and start the local Jekyll development server. The `--livereload` flag enables automatic browser refreshes on changes.

```bash
# Install dependencies
bundle install

# Ruby 3.0+ may need:
bundle add webrick

# Start local server
bundle exec jekyll serve

# Or with live reload
bundle exec jekyll serve --livereload

# Access at http://localhost:4000
```

--------------------------------

### Configure nvim-lspconfig for LSP Setup

Source: https://github.com/julianobarbosa/claude-code-skills/blob/main/skills/neovim/references/plugins.md

Basic setup for nvim-lspconfig, including dependencies for mason.nvim and mason-lspconfig.nvim. Refer to references/lsp.md for full configuration details.

```lua
{
  "neovim/nvim-lspconfig",
  event = { "BufReadPre", "BufNewFile" },
  dependencies = {
    "williamboman/mason.nvim",
    "williamboman/mason-lspconfig.nvim",
  },
  config = function()
    -- See references/lsp.md for full config
  end,
}
```

--------------------------------

### Production Argo CD Installation with Workload Identity

Source: https://github.com/julianobarbosa/claude-code-skills/blob/main/skills/gitops-principles/SKILL.md

Notes on installing Argo CD for production on Azure Arc-enabled Kubernetes using Workload Identity. Recommends using a Bicep template for complete setup.

```bash
# Production with workload identity (recommended)
# Use Bicep template - see references/azure-arc-integration.md
```

--------------------------------

### Complete pyproject.toml Configuration Example

Source: https://github.com/julianobarbosa/claude-code-skills/blob/main/skills/uv/references/project-management.md

A comprehensive pyproject.toml example demonstrating project metadata, dependencies, optional dependencies (extras), entry points, URLs, build system configuration, dependency groups (PEP 735), and uv-specific settings.

```toml
[project]
name = "my-project"
version = "0.1.0"
description = "My awesome Python project"
readme = "README.md"
license = { text = "MIT" }
authors = [
    { name = "Your Name", email = "you@example.com" }
]
keywords = ["python", "example"]
classifiers = [
    "Development Status :: 3 - Alpha",
    "Programming Language :: Python :: 3.11",
    "Programming Language :: Python :: 3.12",
]
requires-python = ">=3.11"

# Main dependencies
dependencies = [
    "requests>=2.28",
    "click>=8.0",
    "pydantic>=2.0",
]

# Optional dependencies (extras)
[project.optional-dependencies]
api = ["fastapi>=0.100", "uvicorn>=0.23"]
database = ["sqlalchemy>=2.0", "alembic>=1.12"]
all = ["my-project[api,database]"]

# Entry points
[project.scripts]
my-cli = "my_project.cli:main"

[project.gui-scripts]
my-gui = "my_project.gui:main"

[project.entry-points."my_project.plugins"]
plugin-a = "my_project.plugins:PluginA"

# URLs
[project.urls]
Homepage = "https://github.com/user/my-project"
Documentation = "https://my-project.readthedocs.io"
Repository = "https://github.com/user/my-project"

# Build system
[build-system]
requires = ["hatchling"]
build-backend = "hatchling.build"

# Dependency groups (PEP 735)
[dependency-groups]
dev = ["pytest>=8", "ruff>=0.5", "mypy>=1.10"]
test = ["pytest-cov>=5", "pytest-asyncio>=0.23"]
docs = ["sphinx>=7", "myst-parser>=3"]
lint = ["ruff>=0.5", "mypy>=1.10", "pre-commit>=3"]

# UV-specific configuration
[tool.uv]
# Default groups to install
default-groups = ["dev"]

# Alternative dev dependencies (deprecated, use dependency-groups)
dev-dependencies = ["pytest", "ruff"]

# Constraint dependencies
constraint-dependencies = ["grpcio<1.65"]

# Override dependencies (force specific versions)
override-dependencies = ["werkzeug==2.3.0"]

# Exclude from resolution
exclude-dependencies = ["some-package"]

# Package indexes
[[tool.uv.index]]
name = "pytorch"
url = "https://download.pytorch.org/whl/cpu"
explicit = true

[[tool.uv.index]]
name = "private"
url = "https://pypi.company.com/simple"

# Dependency sources
[tool.uv.sources]
# Git repository
my-lib = { git = "https://github.com/user/my-lib" }
my-lib-branch = { git = "https://github.com/user/my-lib", branch = "develop" }
my-lib-tag = { git = "https://github.com/user/my-lib", tag = "v1.0.0" }
my-lib-rev = { git = "https://github.com/user/my-lib", rev = "abc123" }

# Local path
local-pkg = { path = "./packages/local-pkg" }
local-editable = { path = "./packages/local-pkg", editable = true }

# Specific index
torch = { index = "pytorch" }

# URL
direct-pkg = { url = "https://example.com/package-1.0.0.whl" }

# Environment markers
[tool.uv.sources.jax]
marker = "sys_platform == 'linux'"

# Target environments for resolution
[tool.uv]
environments = [
    "sys_platform == 'darwin'",
    "sys_platform == 'linux'",
]

# Conflicts (mutually exclusive extras/groups)
[tool.uv]
conflicts = [
    [
        { extra = "cpu" },
        { extra = "cuda" },
    ]
]

# pip interface settings (only for uv pip commands)
[tool.uv.pip]
index-url = "https://pypi.org/simple"

```

--------------------------------

### Complete Atuin Configuration Example

Source: https://github.com/julianobarbosa/claude-code-skills/blob/main/skills/atuin/references/configuration.md

This TOML file shows a comprehensive example of Atuin's configuration options, covering paths, search behavior, UI, input, privacy, sync, network, daemon, stats, and dotfiles.

```toml
# ~/.config/atuin/config.toml

## Core paths (usually defaults are fine)
# db_path = "~/.local/share/atuin/history.db"
# key_path = "~/.local/share/atuin/key"
# session_path = "~/.local/share/atuin/session"

## Search behavior
search_mode = "fuzzy"
filter_mode = "global"
filter_mode_shell_up_key_binding = "session"

## UI
style = "compact"
inline_height = 40
show_preview = true
show_help = true
show_tabs = true
enter_accept = false
invert = false

## Input
keymap_mode = "emacs"
ctrl_n_shortcuts = true

## Privacy
secrets_filter = true
store_failed = true
history_filter = [
  "^password",
  ".*--password.*",
  "^export.*KEY",
  "^export.*SECRET",
  "^export.*TOKEN"
]

## Sync
sync_address = "https://api.atuin.sh"
auto_sync = true
sync_frequency = "1h"

[sync]
records = true

## Network
network_timeout = 30
network_connect_timeout = 5

## Daemon (optional)
[daemon]
enabled = false
sync_frequency = 300

## Stats
[stats]
common_subcommands = [
  "cargo",
  "git",
  "kubectl",
  "docker",
  "npm"
]
common_prefix = ["sudo"]

## Dotfiles (optional)
[dotfiles]
enabled = false

```

--------------------------------

### Vault Builder Tool - Verify Command

Source: https://github.com/julianobarbosa/claude-code-skills/blob/main/skills/vault-setup/SKILL.md

Example of using the VaultBuilder.py tool to verify the vault setup.

```bash
Tools/VaultBuilder.py verify
```

--------------------------------

### Get Tags Response

Source: https://github.com/julianobarbosa/claude-code-skills/blob/main/skills/obsidian-claude-integration/references/mcp-integration.md

Example response structure for a get_tags request, listing all tags in the vault with their counts.

```json
{
  "tags": [
    {"name": "#project", "count": 15},
    {"name": "#project/active", "count": 8},
    {"name": "#reference", "count": 42}
  ]
}
```

--------------------------------

### Install and Run zsh-bench

Source: https://github.com/julianobarbosa/claude-code-skills/blob/main/skills/shell-prompt/references/performance-tuning.md

Install the zsh-bench tool for comprehensive shell prompt performance benchmarking. Run the benchmark to collect various performance metrics.

```bash
# Install
git clone https://github.com/romkatv/zsh-bench ~/zsh-bench

# Run benchmark
~/zsh-bench/zsh-bench

# Output metrics:
# - creates_tty: whether test runs in TTY
# - has_compsys: completion system loaded
# - has_syntax_highlighting: syntax highlighting enabled
# - has_autosuggestions: autosuggestions enabled
# - has_git_prompt: git info in prompt
# - first_prompt_lag_ms: time to first prompt
# - first_command_lag_ms: time for first command
# - command_lag_ms: subsequent command latency
# - input_lag_ms: input responsiveness
# - exit_time_ms: shell exit time
```

--------------------------------

### Base Files Configuration Example

Source: https://github.com/julianobarbosa/claude-code-skills/blob/main/skills/obsidian/References/master.md

An example configuration for a Base File, defining filters for active projects and specifying a table view with custom ordering.

```yaml
# example.base — table of active projects
filters:
  and:
    - file.inFolder("01 - Projects")
    - 'status == "active"'
views:
  - type: table
    name: "Active Projects"
    order: [file.name, status, priority, due_date]
```

--------------------------------

### AWS JMESPath Filtering Examples

Source: https://github.com/julianobarbosa/claude-code-skills/blob/main/skills/using-cloud-cli/AWS.md

Examples of JMESPath queries used with the AWS CLI to filter and shape command output, such as getting instance IDs, filtering by tags, selecting multiple fields, and retrieving the first result.

```bash
# Get instance IDs
--query 'Reservations[].Instances[].InstanceId'
```

```bash
# Filter by tag
--query 'Reservations[].Instances[?Tags[?Key==`Name` && Value==`web`]]'
```

```bash
# Multiple fields
--query 'Reservations[].Instances[].[InstanceId,State.Name]'
```

```bash
# First result
--query 'Reservations[0].Instances[0].InstanceId'
```

--------------------------------

### Configure obsidian.nvim with fzf-lua

Source: https://github.com/julianobarbosa/claude-code-skills/blob/main/skills/obsidian-nvim/references/examples.md

This example configures obsidian.nvim to use fzf-lua as its picker. Make sure fzf-lua is installed and available.

```lua
return {
  "obsidian-nvim/obsidian.nvim",
  version = "*",
  ft = "markdown",
  dependencies = {
    "nvim-lua/plenary.nvim",
    "ibhagwan/fzf-lua",
  },
  opts = {
    workspaces = {
      { name = "notes", path = "~/notes" },
    },
    picker = {
      name = "fzf-lua",
    },
  },
}
```

--------------------------------

### Repomix Configuration File Example

Source: https://github.com/julianobarbosa/claude-code-skills/blob/main/skills/repomix/SKILL.md

An example of a `repomix.config.json` file, demonstrating settings for output, inclusion/exclusion patterns, and security checks.

```json
{
  "$schema": "https://repomix.com/schemas/latest/schema.json",
  "output": {
    "filePath": "repomix-output.xml",
    "style": "xml",
    "compress": false,
    "removeComments": false,
    "showLineNumbers": false,
    "copyToClipboard": false
  },
  "include": ["src/**/*", "**/*.md"],
  "ignore": {
    "useGitignore": true,
    "useDefaultPatterns": true,
    "customPatterns": ["**/*.test.ts", "dist/"]
  },
  "security": {
    "enableSecurityCheck": true
  }
}
```

--------------------------------

### Install Context7 Dependencies

Source: https://github.com/julianobarbosa/claude-code-skills/blob/main/skills/context7/SKILL.md

Install the necessary dependencies for Context7. This command should be run from the specified directory.

```bash
# Install dependencies
cd ~/.claude/skills/context7/Tools
bun install
```