FrancyJGLisboa/agent-skills-platform / references/examples/weekly-crm-report
weekly-crm-report
UnverifiedCleans 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.
| File | Kind | Size |
|---|---|---|
| README.md | markdown | 1.7 KB |
| SKILL.md | skill md | 2.4 KB |
| VERIFICATION.md | markdown | 845 B |
| contracts/data_contract_crm_export/.contract_id | other | 10 B |
| contracts/data_contract_crm_export/code/contract_health.py | script | 386 B |
| discovery.json | config | 2.2 KB |
| evals/golden/case-1/expected.json | config | 126 B |
| evals/golden/case-1/input.csv | other | 62 B |
| evals/golden/case-2/expected.json | config | 129 B |
| evals/golden/case-2/input.csv | other | 46 B |
| evals/golden/case-3/expected.json | config | 106 B |
| evals/golden/case-3/input.csv | other | 39 B |
| evals/weekly-crm-report.eval.md | markdown | 1.8 KB |
| scripts/dependency_health.py | script | 3.9 KB |
| scripts/evolve.pyexecutable | script | 10.2 KB |
| scripts/review_staleness.py | script | 6.2 KB |
| scripts/run_evals.pyexecutable | script | 49.4 KB |
| scripts/run_pipeline.pyexecutable | script | 2.3 KB |
| scripts/schema_drift.py | script | 7.3 KB |
| scripts/skill_document.py | script | 9.8 KB |
| scripts/staleness_check.py | script | 7.5 KB |
| scripts/success_ledger.py | script | 16.5 KB |
README.md
View on GitHub# 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.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| 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: 119k | Updated | Claude CodeCodex | Verified | Install |
| 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: 119k | Updated | Claude CodeCodex | Verified | Install |
| 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: 118k | Updated | Claude CodeCodex | Verified | Install |
| 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: 118k | Updated | Claude CodeCodex | Verified | Install |