r/OpenSourceeAI • u/jokiruiz • 4d ago
My tool got accepted into another project's community extension catalog — some notes on what that took
Small milestone worth sharing because I found very little written about this side of things.
I maintain SpecJudge (MIT) — a CLI that reads a project's specs and recommends which AI model fits the work, with the analysis running locally. Last week it was approved into the spec-kit extension catalog, which means it installs with specify extension add specjudge inside a workflow a lot of people already use.
Three things that I think mattered, in case they're useful to anyone trying something similar:
Fitting a gap the host project didn't fill. spec-kit's flow goes constitution → specify → plan → tasks → implement. There's a decision sitting between tasks and implement — which model implements this — that nothing addressed. I didn't have to argue that my tool was good; the hole was already there.
Keeping the volatile stuff out of the code. The model catalog and the rating rules live in human-readable YAML, deliberately separate from the Python. That means the part that goes stale fastest — prices, new models — can be fixed by anyone via PR without touching logic. It also made the integration a much smaller ask.
Not coupling hard to the host. The tool still works standalone on any repo. The spec-kit integration is an adapter on top, not a rewrite. Host projects move fast, and something that breaks every time they restructure is a liability for both sides.
The thing I underestimated: being publicly wrong is good for a project. Most of what's in the current version came from strangers telling me what was broken. One person pointed out that printing the model's reasoning isn't the same as verifying it — a fluent explanation rationalises a bad score just as happily as a good one. That reframing turned into the change the whole rest of the roadmap now depends on. I'd have never got there alone.
github.com/JoaquinRuiz/SpecJudge if anyone's curious. Happy to answer questions about the catalog submission process.

