Claude GitHub Copilot opencode Skill

finfocus-install

Automated FinFocus CLI and plugin setup workflow. Use when installing finfocus, setting up plugins for cloud providers, initializing configuration, bootstrapping a new finfocus environment, or onboarding a project for cost analysis. Triggers on: "install finfocus", "setup finfocu

LLM Mart · 0 points · 1 views 0 listing impressions 0 install-command copies
Download rshade-finfocus-agent-skills_finfocus-install-835e5f9.zip · 12 KB

Install

skills CLI npx skills add https://github.com/rshade/finfocus/tree/main/agent-skills/finfocus-install
Claude Code claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install rshade-finfocus@llmmart
Git git clone https://github.com/rshade/finfocus.git

The skills CLI installs just this skill, for any of its supported agents. Claude Code installs the whole rshade/finfocus collection as a plugin from our marketplace. Git is the plain clone.

Skill manifest

FinFocus Installation

Quick Path: Existing Install

If finfocus is already installed, prefer the built-in setup command:

finfocus setup                    # Full bootstrap (idempotent)
finfocus setup --skip-analyzer    # Without Pulumi analyzer
finfocus setup --skip-plugins     # Without plugins (offline)
finfocus setup --non-interactive  # CI/CD mode

Setup runs: version check, Pulumi detection, directory creation, config init, analyzer install, and default plugin (aws-public) install.

Full Workflow

Step 1: Check Existing Installation

finfocus --version

If installed, skip to Step 3. If not, continue.

Step 2: Install the CLI Binary

Install script (Linux/macOS):

curl -fsSL https://raw.githubusercontent.com/rshade/finfocus/main/scripts/install.sh | sh
Env Var Purpose
FINFOCUS_VERSION Pin specific version (default: latest)
FINFOCUS_INSTALL_DIR Custom install dir (default: /usr/local/bin or ~/.local/bin)
FINFOCUS_NO_VERIFY=1 Skip SHA256 checksum verification

Go install (fallback/Windows):

go install github.com/rshade/finfocus/cmd/finfocus@latest

Source build (last resort):

git clone https://github.com/rshade/finfocus.git && cd finfocus && make build

Verify: finfocus --version

Step 3: Detect Cloud Providers

Determine which plugins to install:

  1. Check for Pulumi.yaml/Pulumi.yml — scan resource type prefixes (aws:, kubernetes:)
  2. Check Pulumi state (pulumi stack export) for resource types
  3. Check filesystem: ~/.aws/, ~/.config/gcloud/, ~/.azure/, kubeconfig
  4. Default to aws-public if nothing detected

Provider-to-plugin mapping — see references/registry-plugins.md.

Step 4: Install Plugins

finfocus plugin install aws-public
finfocus plugin install opencost

Key flags — see references/install-commands.md for the complete flag reference.

# Region-specific AWS pricing
finfocus plugin install aws-public --metadata="region=us-east-1"

# CI: auto-fallback if version lacks platform assets
finfocus plugin install aws-public --fallback-to-latest

# Reinstall + clean old versions
finfocus plugin install aws-public --force --clean

Step 5: Initialize Configuration

# Inside a Pulumi project → project-local config
finfocus config init
# Creates: $PROJECT/.finfocus/config.yaml + .gitignore

# Global config
finfocus config init --global
# Creates: ~/.finfocus/config.yaml

Config precedence: project-local > global > env vars > defaults.

Step 6: Install Pulumi Analyzer (Optional)

For inline cost estimates during pulumi preview:

finfocus analyzer install
finfocus analyzer check           # Verify setup

Then run: pulumi preview --policy-pack ~/.finfocus/analyzer

Add to PATH for discovery: export PATH="$HOME/.finfocus/analyzer:$PATH"

The pack directory holds PulumiPolicy.yaml, pulumi-language-finfocus (Pulumi 3.270.0 and later), and pulumi-analyzer-policy-finfocus (earlier releases). On Windows both entries end in .exe.

Step 7: Validate

finfocus plugin validate          # Check all plugin binaries
finfocus plugin list --verbose    # Confirm installed plugins
finfocus plugin list --available  # Show registry plugins

Directory Structure

~/.finfocus/
├── config.yaml          # Global configuration
├── plugins/             # Plugin binaries
│   ├── aws-public/<version>/finfocus-plugin-aws-public
│   └── opencost/<version>/finfocus-plugin-opencost
├── cache/               # BoltDB cache (cache.db)
├── logs/                # Log files
└── analyzer/            # Pulumi policy pack
    ├── PulumiPolicy.yaml
    ├── pulumi-language-finfocus
    └── pulumi-analyzer-policy-finfocus

References

Files (finfocus)
  • references
    • install-commands.md 4 KB
      Loading…
    • registry-plugins.md 7.4 KB
      Loading…
  • finfocus-install.skill 6.6 KB · in bundle
  • SKILL.md 4.8 KB
    ---
    name: finfocus-install
    description: >
      Automated FinFocus CLI and plugin setup workflow. Use when installing finfocus,
      setting up plugins for cloud providers, initializing configuration, bootstrapping
      a new finfocus environment, or onboarding a project for cost analysis. Triggers on:
      "install finfocus", "setup finfocus", "configure cost analysis", "install plugins",
      "bootstrap finfocus", "finfocus setup", "add cost tracking", "onboard project",
      or any task involving initial finfocus installation and environment configuration.
    ---
    <!-- Copyright 2025-2026 Richard Shade. Licensed under Apache-2.0. -->
    <!-- SPDX-License-Identifier: Apache-2.0 -->
    
    # FinFocus Installation
    
    ## Quick Path: Existing Install
    
    If finfocus is already installed, prefer the built-in setup command:
    
    ```bash
    finfocus setup                    # Full bootstrap (idempotent)
    finfocus setup --skip-analyzer    # Without Pulumi analyzer
    finfocus setup --skip-plugins     # Without plugins (offline)
    finfocus setup --non-interactive  # CI/CD mode
    ```
    
    Setup runs: version check, Pulumi detection, directory creation, config init,
    analyzer install, and default plugin (`aws-public`) install.
    
    ## Full Workflow
    
    ### Step 1: Check Existing Installation
    
    ```bash
    finfocus --version
    ```
    
    If installed, skip to Step 3. If not, continue.
    
    ### Step 2: Install the CLI Binary
    
    **Install script (Linux/macOS):**
    
    ```bash
    curl -fsSL https://raw.githubusercontent.com/rshade/finfocus/main/scripts/install.sh | sh
    ```
    
    | Env Var | Purpose |
    |---------|---------|
    | `FINFOCUS_VERSION` | Pin specific version (default: latest) |
    | `FINFOCUS_INSTALL_DIR` | Custom install dir (default: `/usr/local/bin` or `~/.local/bin`) |
    | `FINFOCUS_NO_VERIFY=1` | Skip SHA256 checksum verification |
    
    **Go install (fallback/Windows):**
    
    ```bash
    go install github.com/rshade/finfocus/cmd/finfocus@latest
    ```
    
    **Source build (last resort):**
    
    ```bash
    git clone https://github.com/rshade/finfocus.git && cd finfocus && make build
    ```
    
    Verify: `finfocus --version`
    
    ### Step 3: Detect Cloud Providers
    
    Determine which plugins to install:
    
    1. Check for `Pulumi.yaml`/`Pulumi.yml` — scan resource type prefixes (`aws:`, `kubernetes:`)
    2. Check Pulumi state (`pulumi stack export`) for resource types
    3. Check filesystem: `~/.aws/`, `~/.config/gcloud/`, `~/.azure/`, kubeconfig
    4. Default to `aws-public` if nothing detected
    
    Provider-to-plugin mapping — see
    [references/registry-plugins.md](references/registry-plugins.md).
    
    ### Step 4: Install Plugins
    
    ```bash
    finfocus plugin install aws-public
    finfocus plugin install opencost
    ```
    
    Key flags — see [references/install-commands.md](references/install-commands.md)
    for the complete flag reference.
    
    ```bash
    # Region-specific AWS pricing
    finfocus plugin install aws-public --metadata="region=us-east-1"
    
    # CI: auto-fallback if version lacks platform assets
    finfocus plugin install aws-public --fallback-to-latest
    
    # Reinstall + clean old versions
    finfocus plugin install aws-public --force --clean
    ```
    
    ### Step 5: Initialize Configuration
    
    ```bash
    # Inside a Pulumi project → project-local config
    finfocus config init
    # Creates: $PROJECT/.finfocus/config.yaml + .gitignore
    
    # Global config
    finfocus config init --global
    # Creates: ~/.finfocus/config.yaml
    ```
    
    Config precedence: project-local > global > env vars > defaults.
    
    ### Step 6: Install Pulumi Analyzer (Optional)
    
    For inline cost estimates during `pulumi preview`:
    
    ```bash
    finfocus analyzer install
    finfocus analyzer check           # Verify setup
    ```
    
    Then run: `pulumi preview --policy-pack ~/.finfocus/analyzer`
    
    Add to PATH for discovery: `export PATH="$HOME/.finfocus/analyzer:$PATH"`
    
    The pack directory holds `PulumiPolicy.yaml`, `pulumi-language-finfocus`
    (Pulumi 3.270.0 and later), and `pulumi-analyzer-policy-finfocus` (earlier
    releases). On Windows both entries end in `.exe`.
    
    ### Step 7: Validate
    
    ```bash
    finfocus plugin validate          # Check all plugin binaries
    finfocus plugin list --verbose    # Confirm installed plugins
    finfocus plugin list --available  # Show registry plugins
    ```
    
    ## Directory Structure
    
    ```text
    ~/.finfocus/
    ├── config.yaml          # Global configuration
    ├── plugins/             # Plugin binaries
    │   ├── aws-public/<version>/finfocus-plugin-aws-public
    │   └── opencost/<version>/finfocus-plugin-opencost
    ├── cache/               # BoltDB cache (cache.db)
    ├── logs/                # Log files
    └── analyzer/            # Pulumi policy pack
        ├── PulumiPolicy.yaml
        ├── pulumi-language-finfocus
        └── pulumi-analyzer-policy-finfocus
    ```
    
    ## References
    
    - [references/install-commands.md](references/install-commands.md) — Complete CLI
      flag reference for install, setup, config, and plugin commands
    - [references/registry-plugins.md](references/registry-plugins.md) — Available
      plugins, provider mappings, and capability matrix
    

Comments (0)

Sign in to join the conversation.

No comments yet.

Reviews (0)

No reviews yet.