pl-cost-analysis

Automate monthly P&L cost analysis and bonus calculations from PDFs or CSVs.

1|Updated Nov 5, 2025
One-click install
npx skills add https://github.com/devinbostwick/Skills-pl-cost-analysis --skill pl-cost-analysis
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: pl-cost-analysis
Source: https://github.com/devinbostwick/Skills-pl-cost-analysis/tree/main/.
Command: npx skills add https://github.com/devinbostwick/Skills-pl-cost-analysis --skill pl-cost-analysis

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires pdfplumber, pandas, numpy.

What problem does it solve?

This Skill automates monthly P&L cost analysis and bonus calculations for restaurant locations using NET SALES and detailed inventory data, saving finance teams hours and reducing errors.

Core Features & Use Cases

  • COGS calculation: Actual COGS using Beginning Inventory + Purchases - Ending Inventory.
  • Net Sales-based percentages: Uses NET SALES to compute accurate cost percentages for each category.
  • Bonus calculation: Tiered COGS bonuses and Top Line eligibility to drive performance improvements.
  • Multi-location support: Compare Cantina, OAK, WB, and more for benchmark insights.
  • Input flexibility: Works with dual PDFs (Food Usage + Net Sales) or a single P&L CSV for different workflows.

Quick Start

Launch the analysis with:

  • Python: python3 pnl_analyzer_pdf.py foodUsageReport.pdf 4656
  • Or, provide two PDFs (foodUsageReport*.pdf and Gross_Sales*.pdf) for NET SALES based bonuses, optionally with an reimbursement amount.

Frequently Asked Questions about pl-cost-analysis

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate P&L cost analysis and bonus calculations for restaurant locations?

P&L cost analysis automates monthly profit-and-loss review by computing COGS, cost percentages, and manager bonuses from NET SALES and inventory data. This Skill extracts data from PDFs or CSVs, applies tiered bonus logic, and outputs structured results for multi-location comparison and period-over-period variance tracking.

Can I calculate COGS and bonuses using Food Usage Reports and Sales Breakdown PDFs?

Yes. This Skill accepts dual-PDF workflows with Food Usage Reports and Gross Sales breakdowns, extracting NET SALES and inventory data to compute actual COGS using Beginning Inventory + Purchases − Ending Inventory, then calculating tiered bonuses and Top Line eligibility.

What data formats does P&L analysis accept—PDFs, CSVs, or both?

The Skill works with dual PDFs (foodUsageReport and Gross_Sales) for detailed workflows or a single P&L CSV for legacy inputs, enabling flexibility across different restaurant reporting systems and data sources.

How do I compare P&L performance across multiple restaurant locations?

After processing NET SALES and COGS data, the Skill supports multi-location benchmarking by structuring results for cross-location comparisons, enabling finance teams to identify performance variances and benchmark insights across Cantina, OAK, WB, and other locations.

What prerequisites do I need to run P&L cost analysis on restaurant data?

You need Python 3, the dependencies pdfplumber, pandas, and numpy, plus either two PDFs (Food Usage Report + Gross Sales) or a single P&L CSV, and a location identifier to launch the analysis.

Can I integrate P&L results into downstream systems for reporting or decision automation?

Yes. The Skill outputs structured P&L and bonus results suitable for embedding in RAG systems, enabling downstream decision automation, financial reporting pipelines, and bonus approval workflows.