Skip to content

About

Agility CMS component and content models with agent guidance, implementations and evals

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

Agility component library

Ready-made Agility CMS Component Models and Content Models, each with agent guidance: a short, structured note that tells an AI agent when to use the model, when not to, and what to use instead.

Point your agent at this repo (start with AGENTS.md) and it can build pages from components it understands, in an instance set up from these models.

Folder What's in it
models/components/ One JSON file per Component Model: fields, description and agentGuidance
models/content/ One JSON file per Content Model those components use
registry/ and registry.json Next.js source for each component, installable with the shadcn CLI
frameworks/nextjs/ How the Next.js components are built, and which are ported yet
evals/ Prompts and a runner that measure how well an agent picks components
catalog.md The components grouped by job, with the look-alikes side by side
roadmap.md Components to add, from a survey of other block libraries

Status

Early. Twenty components come from Agility's 2026 Next.js demo site and eight were added from a survey of other block libraries (roadmap.md). Every component has agentGuidance (version 1); content models don't yet. Agility is adding a place to store guidance on models; until that ships, an agent can read it here. It will be changed by what the evals show. The model JSON format is described in models/README.md.

Installing a component

This repo is a shadcn registry. In a Next.js app set up for shadcn (npx shadcn@latest init):

npx shadcn@latest add agility/component-library/hero

That adds the component's source to your app (a presentation-only block and its Agility wrapper), the shared Agility data layer and image component, the npm packages they need, the Agility environment variable names in .env.local, and the component's model definition in agility/models/. The code is yours to change.

Available now: hero. The other components are being ported; see frameworks/nextjs/.

Creating the model in your Agility instance is a separate step for now: use the definition in agility/models/ with the Agility MCP server or the Agility CLI.

License

MIT.

About

Agility CMS component and content models with agent guidance, implementations and evals

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages