Claude GitHub Copilot opencode Skill

finfocus-analyzer-setup

Install and configure FinFocus as a Pulumi Analyzer for inline cost estimation during pulumi preview. Use when setting up the analyzer, configuring the policy pack, debugging analyzer issues, or enabling zero-click cost estimates in Pulumi workflows. Triggers on: "set up analyzer

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

Install

skills CLI npx skills add https://github.com/rshade/finfocus/tree/main/agent-skills/finfocus-analyzer-setup
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 Analyzer Setup

Inline cost estimation during pulumi preview via the Pulumi Analyzer protocol. All diagnostics are ADVISORY — never blocks deployments.

Prerequisites

finfocus --version          # FinFocus CLI installed
pulumi version              # Pulumi CLI installed
finfocus plugin list        # At least one cost plugin installed

Quick Setup

finfocus analyzer install           # Install + create policy pack
finfocus analyzer check             # Verify all 4 checks pass

# Add to PATH (required for Pulumi to discover the binary)
export PATH="$HOME/.finfocus/analyzer:$PATH"

# Run preview with costs
pulumi preview --policy-pack ~/.finfocus/analyzer

For persistent PATH, add the export to ~/.bashrc or ~/.zshrc.

Windows (PowerShell): Add to your PowerShell profile ($PROFILE):

$env:PATH = "$env:USERPROFILE\.finfocus\analyzer;$env:PATH"

Restart PowerShell for changes to take effect.

What analyzer install Does

  1. Creates ~/.pulumi/plugins/analyzer-finfocus-v{VERSION}/pulumi-analyzer-finfocus (symlink on Unix, copy on Windows)
  2. Creates ~/.finfocus/analyzer/PulumiPolicy.yaml (runtime: finfocus)
  3. Creates ~/.finfocus/analyzer/pulumi-analyzer-policy-finfocus (Pulumi before 3.270.0)
  4. Creates ~/.finfocus/analyzer/pulumi-language-finfocus (Pulumi 3.270.0 and later)

On Windows both pack entries end in .exe. Running finfocus analyzer install again adds pulumi-language-finfocus to a pack that has only the older entry.

Use --force to reinstall after upgrading finfocus. Use --target-dir to override the Pulumi plugin directory.

Verification

finfocus analyzer check                # Table output
finfocus analyzer check --output json  # JSON for CI

Runs 4 sequential checks (later checks skip if earlier ones fail):

Check Verifies
policy_pack_dir ~/.finfocus/analyzer/ exists
pulumi_policy_yaml PulumiPolicy.yaml has runtime: finfocus
binary_in_path pulumi-analyzer-policy-finfocus on PATH
grpc_smoke_test analyzer serve starts and responds to RPC

Expected Output

Policies:
    finfocus@v0.3.3 (local: ~/.finfocus/analyzer)
        - [advisory]  cost-estimate  (aws:ec2/instance:Instance: my-instance)
          Estimated Monthly Cost: $7.50 USD (source: finfocus-plugin-aws)
        - [advisory]  stack-cost-summary  (pulumi:pulumi:Stack: my-stack)
          Total Estimated Monthly Cost: $7.50 USD (1 resources analyzed)

CI/CD Usage

export PULUMI_POLICY_PACK_PATH="$HOME/.finfocus/analyzer"
pulumi preview    # No --policy-pack flag needed

Troubleshooting

See references/troubleshooting.md for common failure modes, PATH issues, version mismatches, plugin isolation, and config tuning.

Uninstall

finfocus analyzer uninstall              # Remove from Pulumi plugin dir
finfocus analyzer uninstall --target-dir /custom/path
Files (finfocus)
  • references
    • troubleshooting.md 4.2 KB
      Loading…
  • finfocus-analyzer-setup.skill 3.7 KB · in bundle
  • SKILL.md 3.7 KB
    ---
    name: finfocus-analyzer-setup
    description: >
      Install and configure FinFocus as a Pulumi Analyzer for inline cost estimation
      during pulumi preview. Use when setting up the analyzer, configuring the policy
      pack, debugging analyzer issues, or enabling zero-click cost estimates in Pulumi
      workflows. Triggers on: "set up analyzer", "configure analyzer", "install analyzer",
      "Pulumi preview costs", "inline cost estimates", "policy pack setup",
      "analyzer integration", "zero-click cost estimation", "analyzer check",
      or any task involving finfocus Pulumi Analyzer configuration.
    ---
    <!-- Copyright 2025-2026 Richard Shade. Licensed under Apache-2.0. -->
    <!-- SPDX-License-Identifier: Apache-2.0 -->
    
    # FinFocus Analyzer Setup
    
    Inline cost estimation during `pulumi preview` via the Pulumi Analyzer protocol.
    All diagnostics are ADVISORY — never blocks deployments.
    
    ## Prerequisites
    
    ```bash
    finfocus --version          # FinFocus CLI installed
    pulumi version              # Pulumi CLI installed
    finfocus plugin list        # At least one cost plugin installed
    ```
    
    ## Quick Setup
    
    ```bash
    finfocus analyzer install           # Install + create policy pack
    finfocus analyzer check             # Verify all 4 checks pass
    
    # Add to PATH (required for Pulumi to discover the binary)
    export PATH="$HOME/.finfocus/analyzer:$PATH"
    
    # Run preview with costs
    pulumi preview --policy-pack ~/.finfocus/analyzer
    ```
    
    For persistent PATH, add the export to `~/.bashrc` or `~/.zshrc`.
    
    **Windows (PowerShell):** Add to your PowerShell profile (`$PROFILE`):
    
    ```powershell
    $env:PATH = "$env:USERPROFILE\.finfocus\analyzer;$env:PATH"
    ```
    
    Restart PowerShell for changes to take effect.
    
    ## What `analyzer install` Does
    
    1. Creates `~/.pulumi/plugins/analyzer-finfocus-v{VERSION}/pulumi-analyzer-finfocus`
       (symlink on Unix, copy on Windows)
    2. Creates `~/.finfocus/analyzer/PulumiPolicy.yaml` (runtime: finfocus)
    3. Creates `~/.finfocus/analyzer/pulumi-analyzer-policy-finfocus` (Pulumi before
       3.270.0)
    4. Creates `~/.finfocus/analyzer/pulumi-language-finfocus` (Pulumi 3.270.0 and
       later)
    
    On Windows both pack entries end in `.exe`. Running `finfocus analyzer install`
    again adds `pulumi-language-finfocus` to a pack that has only the older entry.
    
    Use `--force` to reinstall after upgrading finfocus. Use `--target-dir` to
    override the Pulumi plugin directory.
    
    ## Verification
    
    ```bash
    finfocus analyzer check                # Table output
    finfocus analyzer check --output json  # JSON for CI
    ```
    
    Runs 4 sequential checks (later checks skip if earlier ones fail):
    
    | Check | Verifies |
    |-------|----------|
    | `policy_pack_dir` | `~/.finfocus/analyzer/` exists |
    | `pulumi_policy_yaml` | `PulumiPolicy.yaml` has `runtime: finfocus` |
    | `binary_in_path` | `pulumi-analyzer-policy-finfocus` on PATH |
    | `grpc_smoke_test` | `analyzer serve` starts and responds to RPC |
    
    ## Expected Output
    
    ```text
    Policies:
        finfocus@v0.3.3 (local: ~/.finfocus/analyzer)
            - [advisory]  cost-estimate  (aws:ec2/instance:Instance: my-instance)
              Estimated Monthly Cost: $7.50 USD (source: finfocus-plugin-aws)
            - [advisory]  stack-cost-summary  (pulumi:pulumi:Stack: my-stack)
              Total Estimated Monthly Cost: $7.50 USD (1 resources analyzed)
    ```
    
    ## CI/CD Usage
    
    ```bash
    export PULUMI_POLICY_PACK_PATH="$HOME/.finfocus/analyzer"
    pulumi preview    # No --policy-pack flag needed
    ```
    
    ## Troubleshooting
    
    See [references/troubleshooting.md](references/troubleshooting.md) for common
    failure modes, PATH issues, version mismatches, plugin isolation, and config
    tuning.
    
    ## Uninstall
    
    ```bash
    finfocus analyzer uninstall              # Remove from Pulumi plugin dir
    finfocus analyzer uninstall --target-dir /custom/path
    ```
    

Comments (0)

Sign in to join the conversation.

No comments yet.

Reviews (0)

No reviews yet.