REPOGEO REPORT · LITE

clawplays/ospec

Default branch main · commit cc7ef664 · scanned 6/8/2026, 10:36:56 AM

GitHub: 581 stars · 33 forks

AI VISIBILITY SCORE

40 /100

Critical

Category recall

0 / 2

Not recommended in any query

Rule findings

2 pass · 0 warn · 0 fail

Objective metadata checks

AI knows your name

3 / 3

Direct prompts that named your repo

HOW TO READ THIS REPORT

Action plan is what to do next — copy-pasteable changes prioritized by impact. Category visibility is the real GEO test: when a user asks an AI a brand-free question that should surface clawplays/ospec, does the AI actually recommend you — or your competitors? Objective checks verify the metadata signals AI engines weight first. Self-mention check detects whether AI even knows you exist by name.

Action plan — copy-paste fixes

3 prioritized changes generated by gemini-2.5-flash. Mark items done after you ship the fix.

OVERALL DIRECTION

highreadme#1

Reposition and strengthen the opening paragraph to clarify OSpec's purpose for AI development

Why:

CURRENT

The current first descriptive sentence is "The official OSpec CLI package is `@clawplays/ospec-cli`, and the official command is `ospec`. OSpec supports spec-driven development (SDD) and document-driven development for AI coding agents and CLI workflows." (This sentence appears after badges and language links).

COPY-PASTE FIX

OSpec is a document-driven development framework for AI coding assistants and agents. It enables spec-driven development (SDD) to define, test, and manage AI agent workflows, ensuring clear requirements and verifiable outcomes. The official OSpec CLI package is `@clawplays/ospec-cli`, and the official command is `ospec`.

mediumreadme#2

Integrate the core problem statement from 'Why OSpec?' earlier in the README

Why:

COPY-PASTE FIX

AI coding assistants are powerful, but managing requirements that live only in chat history is challenging. OSpec provides a lightweight workflow layer to keep proposal, tasks, and change context directly within your repository, before code is written and after work ships.

lowtopics#3

Expand topics with more specific AI agent and workflow keywords

Why:

CURRENT

ai, ai-workflow, document-driven, planning, sdd, spec, spec-driven-development, specification

COPY-PASTE FIX

ai, ai-workflow, document-driven, planning, sdd, spec, spec-driven-development, specification, ai-agents, prompt-engineering, ai-workflow-orchestration, ai-specification

Category GEO backends resolved for this scan: google/gemini-2.5-flash, deepseek/deepseek-v4-flash

Category visibility — the real GEO test

Brand-free queries asked to google/gemini-2.5-flash. Did AI recommend you, or someone else?

Same questions for every model — switch tabs to compare answers and rankings.

Recall

0 / 2

0% of queries surface clawplays/ospec

Avg rank

—

Lower is better. #1 = top recommendation.

Share of voice

Of all named tools, what % are you?

Top rival

pydantic/pydantic

Recommended in 2 of 2 queries

COMPETITOR LEADERBOARD

pydantic/pydantic · recommended 2×
OAI/OpenAPI-Specification · recommended 1×
asyncapi/spec · recommended 1×
swagger-api/swagger-ui · recommended 1×
stoplightio/elements · recommended 1×

CATEGORY QUERY
How can I implement document-driven development for my AI coding assistants?
you: not recommended
AI recommended (in order):
1. OpenAPI (OAI/OpenAPI-Specification)
2. AsyncAPI (asyncapi/spec)
3. Swagger UI (swagger-api/swagger-ui)
4. Stoplight Elements (stoplightio/elements)
5. JSON Schema (json-schema-org/json-schema-spec)
6. Pydantic (pydantic/pydantic)
7. MkDocs (mkdocs/mkdocs)
8. Sphinx (sphinx-doc/sphinx)
9. Stoplight Studio
10. Postman
11. Jupyter Notebooks (jupyter/notebook)
12. Google Colab
AI recommended 12 alternatives but never named clawplays/ospec. This is the gap to close.
Show full AI answer
CATEGORY QUERY
What tools assist with spec-driven development for building reliable AI agents?
you: not recommended
AI recommended (in order):
1. Pydantic (pydantic/pydantic)
2. OpenAPI
3. JSON Schema
4. Gherkin
5. Cucumber (cucumber/cucumber)
6. Behave (behave/behave)
7. LangChain (langchain-ai/langchain)
8. Zod (colinhacks/zod)
9. Protocol Buffers (protocolbuffers/protobuf)
10. gRPC (grpc/grpc)
AI recommended 10 alternatives but never named clawplays/ospec. This is the gap to close.
Show full AI answer

Objective checks

Rule-based audits of metadata signals AI engines weight most.

Metadata completeness
pass
README presence
pass

Self-mention check

Does AI even know your repo exists when asked about it directly?

Compared to common alternatives in this category, what is the core differentiator of clawplays/ospec?
pass
AI named clawplays/ospec explicitly
AI answers can be confidently wrong. Read for accuracy: does it match your actual tech stack, audience, and differentiator?
If a team adopts clawplays/ospec in production, what risks or prerequisites should they evaluate first?
pass
AI named clawplays/ospec explicitly
AI answers can be confidently wrong. Read for accuracy: does it match your actual tech stack, audience, and differentiator?
In one sentence, what problem does the repo clawplays/ospec solve, and who is the primary audience?
pass
AI named clawplays/ospec explicitly
AI answers can be confidently wrong. Read for accuracy: does it match your actual tech stack, audience, and differentiator?

Embed your GEO score

Drop this badge into the README of clawplays/ospec. It auto-updates whenever the report is rescanned and links back to the latest report — easy public proof that you care about AI discoverability.

Live preview

MARKDOWN (README)

[![RepoGEO](https://repogeo.com/badge/clawplays/ospec.svg)](https://repogeo.com/en/r/clawplays/ospec)

HTML

<a href="https://repogeo.com/en/r/clawplays/ospec"><img src="https://repogeo.com/badge/clawplays/ospec.svg" alt="RepoGEO" /></a>

Pro

Subscribe to Pro for deep diagnoses

clawplays/ospec — Lite scans stay free; this card itemizes Pro deep limits vs Lite.

Deep reports10 / month
Brand-free category queries5 vs 2 in Lite
Prioritized action items8 vs 3 in Lite