Feedback on your automating-numbers skill

[RichardHightower]

I took a look at your automating-numbers skill and wanted to share some thoughts.

Links:

• GitHub
• Your agentic skill in the SkillzWave marketplace

The TL;DR

You're at 95/100, solidly in A territory. This is based on Anthropic's best practices for Claude Skills. Your strongest area is Spec Compliance (14/15)—the frontmatter and structure are clean. The weakest is Writing Style (8/10), but honestly, it's a minor issue. Your Progressive Disclosure Architecture (25/30) is where you're leaving a bit on the table.

What's Working Well

• Excellent modular structure — Your 8 reference files are well-organized and let users dig deep without bloating the main SKILL.md. The "What to load" section makes navigation clear.
• Strong trigger coverage — You've got "automate Numbers", "JXA Numbers scripting", "bulk data operations" — these hit the real use cases people search for.
• Solid validation checklist — The 5-step workflow with checkboxes and your pre-commit checklist give developers a real run-check-fix pattern to follow.
• Real-world examples — Input/output pairs for table reads and batch writes feel authentic, not contrived.

The Big One

You're showing the same operation in three languages (JXA, PyXA, PyObjC) in your SKILL.md examples. This burns tokens and dilutes the focus. Since you already recommend PyXA as the modern approach, keep just that one in the main file. Move the JXA and PyObjC variants to a references/numbers-alternatives.md file—users who need those will find them, but you're not forcing everyone to scroll past three ways to do the same thing. This alone should bump you +2 points on token economy.

Other Things Worth Fixing

1. Missing TOCs in short refs — numbers-basics.md, numbers-recipes.md, and numbers-advanced.md jump straight into content. Add a quick bulleted contents section at the top so people can scan before diving in. (+1 point on navigation)

2. Placeholder paths — references/numbers-advanced.md uses /Users/you/Documents/report.numbers. Replace with generic like ~/Documents/report.numbers to keep the imperative voice clean. (+1 point on style)

3. PyXA install gap — You reference installation in the automating-mac-apps skill but don't give standalone instructions. Add a quick pip install PyXA line with a note that full setup is in the parent skill. Helps when people use this independently. (+1 point on utility)

Quick Wins

• Consolidate JXA/PyXA/PyObjC examples → move alternatives to new ref file (biggest impact)
• Add TOCs to short reference files (easy, helps discoverability)
• Fix placeholder paths to generic format
• Add quick PyXA install instruction

You've built something solid here. These tweaks should get you to 98–99/100 easily.

---

Checkout your skill here: SkillzWave.ai | SpillWave We have an agentic skill installer that install skills in 14+ coding agent platforms. Check out this guide on how to improve your agentic skills.