Documentation

A construct is a complete definition of who an AI agent is and how it thinks. Unlike a simple prompt, a construct defines an agent's identity, decision framework, workflow, and boundaries.

Constructs come in many forms — SOUL.md files that define personality, SKILL.md files that define capabilities, AGENTS.md files that define behavior, and more. What they share is a common purpose: making AI agents more useful, consistent, and composable.

There are three ways to install a construct:

Ask your agent to visit the raw URL. Every construct has a raw endpoint that returns plain text any LLM can ingest directly. Just tell your agent: "visit constructs.sh/username/construct-name/raw"

Copy the content. On any construct's detail page, click "Copy File" to copy the full content to your clipboard. Paste it into your agent's configuration.

Download the file. Click "Download" to save the construct as a markdown file. Place it in your agent's config directory (e.g., .claude/skills/ for Claude Code, .cursor/rules/ for Cursor).

Constructs support three formats:

Markdown — The most common format. Structured prose with YAML frontmatter for metadata. Compatible with virtually every agent harness.

YAML — Structured data format used by CrewAI, LangChain, and other frameworks that define agents as configuration.

JSON — Machine-readable format used by elizaOS characterfiles and programmatic agent systems.

All formats use the same data model on constructs.sh — name, description, content, tags, and license.

Anyone with an account can publish constructs.

1. Sign in and click Publish in the navigation
2. Give your construct a name and description
3. Paste or write the content
4. Add tags for discoverability
5. Choose a format (markdown, YAML, JSON)
6. Choose a license
7. Optionally set a price (requires Stripe connection)

Your construct gets a permanent URL, a raw endpoint for agents, and a unique mesh gradient identity.

Every public construct can be forked. A fork creates a copy under your account that you can modify freely. The fork maintains a link to the original for attribution.

Forks are how the community improves constructs over time. Find a construct that's 80% of what you need? Fork it, adapt it, publish your version.

If the original construct uses a MIT+Royalty license and you sell your fork, the original author automatically receives a royalty percentage.

When publishing, choose a license that matches how you want your construct used:

MIT — Free to use, modify, and distribute. The most permissive option.

CC-BY — Free to use with attribution required.

CC-NC — Free for non-commercial use only.

MIT + Royalty — Free to use and fork, but if someone sells a fork, you automatically receive a royalty (default 10%).

Proprietary — All rights reserved. Cannot be forked.

Constructs are designed to be portable across agent harnesses:

Claude Code — Place in .claude/skills/ as SKILL.md files

Cursor — Place in .cursor/rules/ or as .cursorrules

Windsurf — Place as .windsurfrules or in global rules

OpenClaw — Place as SOUL.md in your clawd directory

Cline — Place as .clinerules files

Any LLM agent — Copy the content into your agent's system prompt or configuration

Constructs can be free or paid. To sell constructs:

1. Go to Settings and connect your Stripe account
2. When publishing, set a price ($1 minimum, $999 maximum)
3. Platform fee is 10% — you keep 90%
4. If your construct is a fork, the original author receives a royalty

Paid constructs show a preview to browsers. Full content is unlocked after purchase.