Clarity

🥈Silver

Clarity is a financial analysis agent framework built on native Claude-skill architecture. Adopting a Planning-with-Files approach, it coordinates specialized sub-agents via persistent task plans, research findings, and progress logs to tackle complex financial analysis workflows.

46100Updated 2mo ago

Intermediate30min to implementautomation

Saves ~75 min per use

Quick InstallView Source

git clone https://github.com/cooragent/Clarity.git

Works with:

Claude

Overview

About This Skill

How to Use

1. **Initialize the Clarity Framework:** - Open your AI assistant (e.g., Claude, ChatGPT) and load the Clarity skill. - Create a dedicated workspace folder for the analysis (e.g., `GreenLeaf_Analysis_2024`). - Ensure you have access to the company’s financial data (e.g., income statements, balance sheets, market reports) and upload them to the workspace. 2. **Define the Scope:** - Use the prompt template to specify the company name, analysis areas (e.g., revenue trends, cost structures), and any specific focus areas (e.g., supply chain risks, regulatory compliance). - Example: `Act as the Clarity financial analysis agent framework. Analyze Acme Corp’s 2023 financials with a focus on revenue diversification and debt covenants.` 3. **Monitor and Iterate:** - Clarity will generate three key files: `Task_Plan.md`, `Research_Log.md`, and `Progress_Log.md`. Review these files after each sub-agent completes its tasks. - Use the `Progress_Log.md` to track milestones and adjust the `Task_Plan.md` if new priorities emerge (e.g., a sudden regulatory change). 4. **Validate and Refine:** - Cross-check Clarity’s findings with your internal data or financial models. Flag any discrepancies (e.g., if Clarity’s revenue growth estimate differs from your CFO’s report by >5%). - Request Clarity to re-run specific analyses (e.g., `Re-run the cost structure analysis with updated Q1 2024 data`). 5. **Generate Deliverables:** - Use Clarity’s final report to create executive summaries, board presentations, or investor decks. Export the visualizations (charts/graphs) directly from the `Research_Log.md` or `Progress_Log.md` files. **Tips for Better Results:** - **Data Quality:** Ensure uploaded financial data is clean, complete, and formatted consistently (e.g., CSV with columns for `Revenue`, `COGS`, `SG&A`). - **Specificity:** The more precise your [SPECIFIC_ANALYSIS_AREAS] are, the more targeted Clarity’s sub-agents will be. Avoid vague requests like 'analyze financials'—instead, specify 'analyze working capital trends and compare to industry peers.' - **Collaboration:** Share the `Task_Plan.md` and `Progress_Log.md` with your finance team to align on priorities and avoid redundant work. - **Version Control:** Save incremental versions of the analysis files (e.g., `GreenLeaf_Analysis_v1.md`, `v2.md`) to track changes over time.

Setup & Installation

Quick Install

No install command available. Check the GitHub repository for manual installation instructions.

Alternative Install (Git Clone)

git clone https://github.com/cooragent/Clarity

Requirements

Claude Code or compatible AI agent
Works with: Claude

Quick Start Guide

Install the Skill

Copy the install command above and run it in your terminal.

Open Your AI Agent

Launch Claude Code, Cursor, or your preferred AI coding agent.

Try It Out

Use the prompt template or examples below to test the skill.

Customize

Adapt the skill to your specific use case and workflow.

Usage Examples

Prompt Template

Act as the Clarity financial analysis agent framework. You will coordinate specialized sub-agents to perform a comprehensive financial analysis of [COMPANY_NAME]. Use a Planning-with-Files approach to create a persistent task plan, document research findings in [RESEARCH_LOG_FILE], and track progress in [PROGRESS_LOG_FILE]. Focus on [SPECIFIC_ANALYSIS_AREAS] such as revenue trends, cost structures, profitability metrics, and risk factors. Provide actionable insights with supporting data and visualizations where applicable.

Example Output

### Clarity Financial Analysis Report: GreenLeaf Organics (2023)

**Executive Summary:**
GreenLeaf Organics, a mid-sized organic food distributor, achieved $124.7M in revenue in 2023, marking a 15% YoY growth. However, gross margins compressed to 28.3% (down from 31.2% in 2022) due to rising supply chain costs. The company’s EBITDA margin of 12.1% falls below industry peers (14.8%), primarily driven by inefficiencies in logistics and inventory management.

**Key Findings:**
1. **Revenue Growth:** Organic produce sales (+22% YoY) outpaced packaged goods (+8%), aligning with consumer trends favoring fresh, unprocessed foods. The West Coast region contributed 41% of total revenue, while the Midwest lagged at 18%.

2. **Cost Pressures:** Supply chain disruption costs surged by 34% YoY, with the highest impact in Q3 ($8.2M). Fuel expenses alone accounted for 6.2% of total revenue, compared to 4.5% in 2022.

3. **Profitability Metrics:** 
   - Gross Margin: 28.3% (Industry Avg: 30.5%)
   - EBITDA Margin: 12.1% (Industry Avg: 14.8%)
   - Net Profit Margin: 6.9% (down from 8.2% in 2022)

4. **Risk Factors:**
   - **Supplier Concentration:** 68% of organic produce sourced from 3 primary vendors, increasing dependency risk.
   - **Regulatory Compliance:** New FDA labeling requirements (effective 2024) may require $2.1M in system upgrades.
   - **Working Capital:** DSO (Days Sales Outstanding) increased to 42 days (up from 38 days in 2022), straining cash flow.

**Recommendations:**
- **Supply Chain Optimization:** Negotiate long-term contracts with 2-3 additional organic suppliers to reduce dependency and improve pricing power. Target a 10% reduction in supply chain costs by Q3 2024.
- **Inventory Management:** Implement a just-in-time (JIT) inventory system for high-turnover items to reduce carrying costs by 15%.
- **Regulatory Preparedness:** Allocate $1.8M in 2024 for compliance upgrades, prioritizing label redesign and ERP system modifications.
- **Cash Flow Improvement:** Offer early payment discounts to customers (2/10 net 30) to reduce DSO to 35 days by year-end.

**Visualizations:**
- Revenue Growth by Region (Bar Chart)
- Cost Breakdown by Category (Pie Chart)
- EBITDA Margin Trend (Line Graph)

**Next Steps:**
1. Share this report with the CFO and Operations team for validation.
2. Schedule a workshop with the supply chain team to prioritize vendor diversification.
3. Begin the RFP process for compliance system upgrades by March 15, 2024.

**Sub-Agent Contributions:**
- **Market Research Agent:** Provided industry benchmarks and consumer trend data.
- **Cost Analysis Agent:** Identified inefficiencies in logistics and inventory.
- **Risk Assessment Agent:** Highlighted regulatory and supplier concentration risks.

**Files Generated:**
- `GreenLeaf_2023_Research_Log.md` (Detailed findings and sources)
- `GreenLeaf_2023_Progress_Log.md` (Task completion status and next steps)
- `GreenLeaf_2023_Task_Plan.md` (Persistent plan with sub-agent assignments)