Observed Signal · May 2, 2026 · Technical Release · Source: DEV Community · Impact: 4/5 · Sentiment: Neutral

AI Instruction Split: AGENTS.md, SKILL.md, DESIGN.md

Executive Signal Summary

The article describes a growing three-layer standard for instructing AI agents: AGENTS.md for overall agent behavior and boundaries, SKILL.md for reusable task procedures (used by Anthropic's Claude Skills and the Agent Skills standard), and DESIGN.md — a Google Labs design-spec format released in April 2026 that combines machine-readable design tokens (YAML) with human-readable intent and ships with a CLI validator (npx @google/design.md lint). The author argues these formats separate verifiable rules (tokens, audits, structural checks) from judgment-based guidance (tone, stance), and situates the split alongside Spec-Driven Development (SDD) workflows (Kiro, GitHub Spec Kit). The three-layer approach is presented as complementary to SDD and intended for incremental adoption where verification adds value.

Polaris7 AgentPolaris7 Strategic Assessment
High Confidence

A technical specification and validator released by Google Labs (a major platform) can standardize machine-readable design tokens and agent instruction formats, influencing developer tooling, UI generation by agents (Stitch), and cross-vendor agent interoperability—impacting how teams operationalize AI agents and specs.

SIGNAL RADAR

Track Anthropic Signals & Market Shifts in Real-Time

Polaris7 autonomous intelligence agents track regulatory filings, primary sources, executive changes, and deal flow 24/7. Create your free Explorer workspace to monitor these entities.

Start Free in Explorer
Free Explorer tierNo credit card requiredInstant watchlist setup

Key Takeaways & Evidence Grounding

  • Google Labs published the DESIGN.md specification on April 10, 2026 and provides a reference implementation used by Stitch.
  • DESIGN.md files contain machine-readable design tokens in YAML and human-readable design intent in Markdown, and Google ships a CLI validator: npx @google/design.md lint.
  • AGENTS.md emerged as an industry standard since 2025 (jointly developed by OpenAI, Google, Sourcegraph, Cursor, and Factory) and was donated to the Linux Foundation in December 2025.
  • SKILL.md is the file format standardized by agentskills.io and underpins Anthropic's Claude Skills; the same SKILL.md can run across Claude Code, Claude.ai and other Agent SDKs.
  • The DESIGN.md repo had over 11,000 stars on GitHub as of early May 2026 and the spec includes linting checks such as token integrity and WCAG contrast ratios.

Ontology Mapping & Concepts

Primary Source Grounding & Direct Attribution
Direct Origin Attribution
Primary Reporting: DEV Community•Published: May 2, 2026
Original Coverage Title: “AGENTS.md, SKILL.md, DESIGN.md: How AI Instructions Split into Three Layers”

Related Market Signals & Shifts

Recent verified developments and strategic activity across this market segment.

Large Language Models (LLM) & AIMay 6, 2026

AgentSkills: Teach AI Agents How to Execute Tasks

The article describes a gap in many LLM-based agent applications: agents often know what to do but not how to do it reliably. It introduces AgentSkills (aka Procedure Skills) — self-contained, structured playbooks (commonly formatted as SKILL.md) that bundle YAML frontmatter, step-by-step execution instructions, small automation scripts, domain resources, and output templates. The author explains why embedding full procedures in large system prompts fails (fragility, token waste, inconsistency) and advocates progressive disclosure: a discovery phase that loads only skill names/descriptions and an activation phase that loads full skill assets when a match occurs. The piece gives design principles for effective skills (imperative language, explicit failure states, small composable units) and explains when skills materially improve agent reliability and cost-efficiency. Published May 6, 2026 by Sreeni Ramadorai on DEV Community.

Read assessment
Creative Orchestration (DCO & Design)Jun 27, 2026

DESIGN.md vs tokens.json vs Figma for AI Agents

A developer post (PromptMaster) published on 2026-06-27 compares three approaches for giving AI agents design context: tokens.json, prose README files, and Figma links — and argues DESIGN.md combines the strengths of all three. The article states tokens.json provides exact values but cannot express application rules; prose README files can express rules but lack structured, machine-readable tokens; and Figma is designed for humans and is unreadable directly by coding agents. DESIGN.md is presented as a single, versioned file that provides structured values, expressible rules, machine readability, and persistence, and can export to Tailwind and the W3C DTCG standard via a CLI (npx @google/design.md). The post includes links to a free cheat sheet and a paid full guide on Gumroad.

Read assessment
Large Language Models (LLM) & AIApr 17, 2026

AI Coding Agents Need Product Design Context

The article argues that AI coding agents can fully read a codebase but still produce generic, off-brand outputs because much of a product’s identity—tone, visual language, interaction principles and positioning—does not live in code. The author, Gregory Muryn‑Mukha, describes seven distinct types of knowledge that form a product’s “design context” and documents a practical solution: a Claude Code skill directory (.claude/skills/<product>-context/) that organizes progressive, task‑specific files (SKILL.md router, design.md, quickref, references) to load the right design and engineering constraints into an agent. The piece details how the skill was iteratively built, common failure modes, use cases (Figma→code lookup, component authoring, product brainstorming, landing‑page copy), and maintenance trade-offs such as drift and the need for periodic review.

Read assessment

Track Real-Time Market Signals & Shifts

Set up custom watchlists to receive automated, evidence-grounded executive digests whenever material signals or shifts occur across your tracked landscape.