metaobjects-audit

Audit a project's MetaObjects adoption and produce a scored, prioritized findings report.

1|Updated May 14, 2026
One-click install
npx skills add https://github.com/metaobjectsdev/metaobjects --skill metaobjects-audit-metaobjectsdev
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: metaobjects-audit
Source: https://github.com/metaobjectsdev/metaobjects/tree/main/agent-context/skills/metaobjects-audit
Command: npx skills add https://github.com/metaobjectsdev/metaobjects --skill metaobjects-audit-metaobjectsdev

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Hand-written code that duplicates what typed metadata already describes becomes a second source of truth that silently drifts. This Skill systematically hunts those duplicates across a codebase — validators, mappers, routes, prompts, SQL views — and produces a scored, prioritized adoption-audit report without ever modifying the project. ## Core Features & Use Cases - Read-only adoption audit: Classifies a project as greenfield, partial, or deep adoption, then works an 8-axis surface review (codegen candidates, drift hotspots, prompt pillar, drift gates, runtime contracts, vocabulary hygiene) and emits .metaobjects/adoption-audit.json plus a rendered Markdown report. - Registry-grounded capability checklist: Ships a per-port reference set (TypeScript, Java, Kotlin, C#, Python) with drift signatures to grep for, calibration guards that prevent false findings, and cross-language version-skew detection via metamodelVersion. - Use Case: Point it at a monorepo with a TypeScript web client and a Java backend; it flags hand-written Zod schemas shadowing generated ones, an un-wired meta verify CI gate, and a stale npm client whose metamodel version disagrees with the Maven backend. ## Quick Start Audit this repository's MetaObjects adoption and produce the scored findings report.

Frequently Asked Questions about metaobjects-audit

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I audit a project's MetaObjects adoption?

Run the audit against the repository root; it triages MetaObjects presence, classifies the project as greenfield, partial, or deep, then works an 8-axis surface review. It writes findings to .metaobjects/adoption-audit.json plus a rendered Markdown report without editing any code.

What drift signatures does a metadata adoption audit look for?

It hunts hand-written validators shadowing generated schemas, field-by-field DTO mappers, camelCase-to-snake_case maps, keep-in-sync comments, runtime schema patching, duplicate shape declarations, and hand-written SQL views that projections or entity read-views could replace.

Does the audit support Java, Kotlin, C#, and Python projects?

Yes, it ships per-port reference guides for TypeScript, Java, Kotlin, C#, and Python covering generated-file locations, codegen commands, drift signatures, and calibration gaps. Cross-language version consistency is checked via each port's reported metamodelVersion.

Will the audit modify my code or metadata?

No, the audit is strictly read-only. It never edits code or authors metadata; each finding may include a metadata_sketch proposal for human review, and actual cutovers are routed to separate skills per finding tier.

Why does the audit flag field.string with @dbColumnType uuid?

That pairing generates a String property over a uuid column, forcing String-to-UUID coercion at every boundary, and verify --db cannot catch it because the column type matches. The recommended fix is field.uuid, staged by blast radius.

When is an absent requirement ledger not a defect?

The requirement.* capability ledger is entirely opt-in, so a project declaring no requirement nodes sees no diagnostics and absence is never scored as a defect. The audit instead scores the hand-written prose, such as a CAPABILITIES.md, that the ledger would replace.