surface-auditlisted

Score whether an API, SDK, or documentation surface can actually be used by developers and AI agents, then rank the gaps by impact. Audits the API contract, documentation, time-to-first-value, SDKs and examples, MCP tooling, auth and permissions, and observability, and writes a report with a remediation sequence. Works on a local repo, an OpenAPI or GraphQL schema, a docs directory, or a public developer site. Use when asked whether a product is agent-ready or developer-ready, to audit or score a developer surface, to find adoption or integration friction, or to review an API before exposing it to AI agents.
agentrel/skills · ★ 0 · AI & Automation · score 73

Install: claude install-skill agentrel/skills

# Surface audit Score a developer surface across seven core dimensions and three conditional ones, then produce a ranked remediation sequence. Read-only: never modify the audited project. Load `references/rubric.md` before scoring. It holds the per-dimension criteria and the band definitions. Do not score from memory — the rubric is the contract, and consistent scores across runs are the point of this skill. ## Applies to | | | |---|---| | **Project types** | REST or GraphQL APIs, SDKs, developer platforms, internal services being opened up to other teams | | **Stage** | Any stage with a callable surface. Highest value before an integration push, before exposing anything to agents, or when adoption has stalled with no obvious cause | | **Needs** | A repository, or a public docs URL plus a reachable spec | | **Skip if** | There is no API or SDK yet — there is nothing to score. Or you want one dimension in depth, in which case run that skill directly | Works on a partial surface. Missing artifacts are findings, not blockers, so an early-stage product gets a useful report — it just gets a low one. ## How to use ``` /agentrel:surface-audit audit the current repository /agentrel:surface-audit ./packages/api audit a subdirectory /agentrel:surface-audit https://docs.acme.com audit a public surface ``` Takes a few minutes. Produces `surface-audit-report.md` plus a printed score table. Read-only — nothing in the audited project is modified