Skip to content

FrancyJGLisboa/agent-skills-platform / references/examples/weekly-crm-report

weekly-crm-report

Unverified

Cleans a weekly CRM export and produces a regional sales summary. Activates when the user asks to clean a CRM export, deduplicate sales rows, calculate regional totals, or generate a weekly sales report from a CSV.

# weekly-crm-report

A bundled example skill: turns a raw weekly CRM export (CSV) into a clean
regional sales summary — drops duplicate rows, totals revenue per region, and
emits structured JSON.

It is small but real, and demonstrates the creator's full machinery end to
end: SKILL.md activation, a `run_pipeline.py` orchestrator, and a bundled
eval spec with golden cases.

## Requirements

Python 3.10+ only — the pipeline uses the standard library (no third-party
dependencies, no requirements.txt needed).

## Run it

```bash
python3 scripts/run_pipeline.py \
  --input evals/golden/case-1/input.csv \
  --output /tmp/crm-summary.json
cat /tmp/crm-summary.json
```

Input: a CSV with at least `region` and `amount` columns (extra columns are
ignored; fully duplicated rows are removed before totalling).

## Run the evals

```bash
python3 scripts/run_evals.py . --validate   # check the eval spec is well-formed
python3 scripts/run_evals.py . --rollout    # execute the skill on golden inputs
python3 scripts/run_evals.py . --rollout --promote   # capture first baselines
python3 scripts/success_ledger.py summary            # inspect local durable-use metrics
```

The eval spec lives in `evals/weekly-crm-report.eval.md` with three golden
cases under `evals/golden/`.

## Layout

```
weekly-crm-report/
├── SKILL.md                  # activation + usage contract
├── scripts/run_pipeline.py   # CSV → dedup → regional totals → JSON
├── scripts/run_evals.py      # eval runner (validate / rollout / promote)
├── scripts/success_ledger.py # private local lifecycle metrics
└── evals/                    # eval spec + golden cases
```

## Verification

[VERIFICATION.md](VERIFICATION.md) records the latest generation-time gate and eval evidence.
deprecation-and-migrationaddyosmani/agent-skillsManages deprecation and migration. Use when removing old systems, APIs, or features. Use when migrating users from one implementation to another. Use when migrating a database schema in production, such as renaming or dropping a column without downtime (expand/contract). Use when deciding whether to maintain or sunset existing code.Stars: 119kUpdated Claude CodeCodexVerifiedInstall
performance-optimizationaddyosmani/agent-skillsOptimizes application performance across frontend, backend, queries, and databases. Use when performance requirements exist, when you suspect performance regressions, when Core Web Vitals or load times need improvement, when N+1 query patterns need fixing, or when profiling reveals bottlenecks.Stars: 119kUpdated Claude CodeCodexVerifiedInstall
agent-cost-reportthedotmack/claude-memBelievable agent cost report for any period, default the last 7 full days PT, not counting today. Measured tokens from Claude Code transcripts priced at OpenRouter list prices (ESTIMATED), measured provider spend when a sanctioned source exists, note-taker cost separate, Timing-style HTML/PDF plus report.json, line-items.csv, evidence.json.Stars: 118kUpdated Claude CodeCodexVerifiedInstall
agent-cost-reportthedotmack/claude-memBelievable agent cost report for any period, default the last 7 full days PT, not counting today. Measured tokens from Claude Code transcripts priced at OpenRouter list prices (ESTIMATED), measured provider spend when a sanctioned source exists, note-taker cost separate, Timing-style HTML/PDF plus report.json, line-items.csv, evidence.json.Stars: 118kUpdated Claude CodeCodexVerifiedInstall