metaobjects-fit-assessment

Assesses whether a project should adopt MetaObjects and produces an evidence-cited fit and migration report.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Teams considering MetaObjects (the cross-language typed metadata standard) lack a rigorous way to decide whether adoption pays off. This Skill runs a read-only, pre-adoption assessment of a target repository and produces a decision-grade report covering fit, what would migrate, the end-state, and the drift-protection payoff — with every claim cited to file:line evidence. ## Core Features & Use Cases - Drift ledger with git archaeology: Hunts ten classes of drift exposure (duplicate validators, DTO mappers, opaque JSON columns, scattered prompts) and proves drift already happened via commit history. - Table-first census and reconciliation: Reconstructs the live table set from migrations, counts ORM classes, read models, and payload shapes, and predicts the future metadata spine size. - Fit rubric and migration waves: Works a disqualifier table row-by-row, then lays out parity-gated adoption waves from a zero-churn wedge to full spine ownership. - Use Case: Point an AI assistant at a TypeScript or Java repository that has not adopted MetaObjects; it emits metaobjects-fit/fit-assessment.md plus a machine-checkable JSON twin without modifying any code. ## Quick Start Ask the assistant to run a MetaObjects fit assessment on this repository and write the report to metaobjects-fit/fit-assessment.md.

Frequently Asked Questions about metaobjects-fit-assessment

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

FAQPage Schema
How do I assess whether my project should adopt MetaObjects?

Run this pre-adoption fit assessment against your repository. It detects your stack, counts entities and drift exposures, works a disqualifier rubric, and writes a decision-grade report with a phased migration plan to metaobjects-fit/fit-assessment.md.

What does the MetaObjects fit assessment report contain?

The report contains a stack detection, a reconciled entity census, a drift ledger with git archaeology evidence, a worked fit rubric, a wave-based migration plan, an end-state projection, and a machine-readable JSON twin of every prediction.

Which languages and databases does the assessment support?

It evaluates backends in TypeScript, Java, Kotlin, C#, and Python — the five MetaObjects ports. Relational stores are required for full value; schema migration and verify --db gates apply only to Postgres, SQLite, and D1.

Does the fit assessment modify my code or install anything?

No. The assessment is strictly read-only and propose-only: it never edits code, authors metadata files, or installs packages. Every metadata sketch is a proposal, and actual adoption happens later via meta init and the adoption skills.

When is a project NOT a fit for MetaObjects?

Structural disqualifiers include a backend outside the five supported languages, no relational store, or a non-entity-shaped domain. Small projects are only a non-fit if they will not grow, which is why the assessment asks about trajectory rather than inferring it from code size.