README.md

README.md

1. # Meridian Skills
3. Twenty Claude skills for the jobs that come round every week at a print and
4. display shop: routing and triaging the CRM, enriching and loading outreach
5. cohorts, pulling production speeds and product specs off the storefront,
6. rebuilding vendor artwork templates, prepping low-resolution artwork for
7. upscaling, writing SOPs, and answering customers in one person's voice.
9. **The company is fictional.** These skills were built for, and used every day
10. at, a real print and display shop. Here they serve **Meridian Display Co.**,
11. the invented company behind
12. [meridian-ops-board](https://github.com/mattrguerra/meridian-ops-board),
13. [meridian-crm-mcp](https://github.com/mattrguerra/meridian-crm-mcp) and
14. [meridian-orders-mcp](https://github.com/mattrguerra/meridian-orders-mcp).
15. Its staff, clients, products, storefront, prices and examples are all invented;
16. the skills and what they teach are the real ones. The one real person is Matt
17. Guerra, who built them: `matt-guerra-email` is his own voice with customers.
19. ## The skills
21. | Skill | What it does | Works with |
22. |---|---|---|
23. | **CRM and outreach** | | |
24. | `bitrix-pipeline-board` | An interactive board of the open lead pipeline by owner and stage, each lead linked | Bitrix24 |
25. | `bitrix-task-router` | Assigns open tasks by a routing rule, previews every change, writes only on `--commit` | Bitrix24 |
26. | `bitrix-tracker` | A read-only digest: overdue, unassigned, stale, changed since yesterday | Bitrix24 |
27. | `matt-easy-win-bitrix-triage` | Finds leads that should close as junk or out of scope, and produces a reviewed worklist first | Bitrix24 |
28. | `client-enrich` | Enriches outreach client records with company and contact research, written back per contract | Apollo, Apify |
29. | `partner-pipeline-push` | Pushes an enriched cohort into a deal funnel and posts each profile on its deal | Bitrix24 |
30. | **Catalog and storefront** | | |
31. | `product-lookup` | Product sizes, materials and options for the catalog | |
32. | `site-safe-fetch` | Crawls the storefront without tripping its WAF or saturating the origin | |
33. | `production-speed-csv` | A CSV of turnaround options for every product in a category, with an offline test fixture | |
34. | `category-page-filter` | Designs a category page's filter sidebar and renders a working prototype | |
35. | `thanksio-postcard-formatter` | Turns an order export into clean, ready-to-send postcard mailing CSVs | Thanks.io |
36. | **Artwork and images** | | |
37. | `artwork-template-rebuilder` | Rebuilds an off-standard vendor artwork template to the house standard, layers and all | PDF |
38. | `topaz-prepress` | Preps low-resolution images for an upscale and recommends the Topaz model and settings per image | Topaz Gigapixel |
39. | `lowres-logo-rescue` | Denoises, upscales, sharpens and flattens a blurry logo until it is readable and traceable | Python |
40. | `kittl-ai-edit` | Drives Kittl's AI image tools to fix a mockup while keeping its artwork, text and colours | Kittl, Claude in Chrome |
41. | **Writing and documents** | | |
42. | `matt-guerra-email` | Drafts and replies to customer email in Matt Guerra's voice | |
43. | `sop-author` | Writes an SOP in the company's .docx format, from a structured spec | Word (.docx) |
44. | **Team and general** | | |
45. | `preferences-setup` | Interviews a staff member and writes their Claude personal-preferences block | Claude Teams |
46. | `cowork-project-architect` | Scaffolds a complete Claude project as an Obsidian vault, through intake and sign-off | Claude, Obsidian |
47. | `plan-build-loop` | Plans every item in a list against one goal, gets one sign-off, then builds them all | Claude |
49. Each skill is a folder under `skills/`: its `SKILL.md` (the instructions
50. Claude follows, with the frontmatter that decides when it triggers), plus any
51. `scripts/`, `references/`, `templates/` or `assets/` it uses.
53. ## Build and install
55. ```bash
56. python3 scripts/pack_skill.py # every skill -> dist/<name>.skill
57. python3 scripts/pack_skill.py sop-author # just one
58. ```
60. A `.skill` file is the skill's folder as a zip, the format Claude installs
61. skills from. The pack script refuses a folder whose
62. frontmatter `name` does not match its folder, because that name is how an
63. installed skill is identified. It leaves out a local `.env` or `config.json`,
64. which hold live webhook URLs.
66. Some skills run Python scripts. They need Python 3.10+, and a few need
67. packages: `python-docx` (sop-author), `pillow`, `numpy`, `opencv-python`,
68. `scikit-learn` and `scipy` (the image skills), `reportlab`, `pdfplumber` and
69. `pikepdf` (artwork-template-rebuilder). The Bitrix scripts run offline against
70. their bundled samples with `--mock`.
72. ## Checks
74. Everything here runs offline, with no credentials and no packages beyond
75. `pytest`:
77. ```bash
78. python3 scripts/pack_skill.py # all twenty skills pack
79. python3 -m pytest tests # the fixture diff and both --mock runs
80. ```
82. The tests wrap three commands that can also be run by hand:
84. ```bash
85. (cd skills/production-speed-csv/scripts && python3 build_speed_csv.py fixtures/category-10x10-booths.html /tmp/speeds.csv && diff /tmp/speeds.csv fixtures/expected.csv)
86. python3 skills/bitrix-task-router/scripts/bitrix_router.py --mock
87. python3 skills/bitrix-tracker/scripts/bitrix_tracker.py --mock
88. ```
90. CI (`.github/workflows/checks.yml`) runs the pack, the tests and an em dash
91. scan on every push.