Skip to Content
For AI & agentsAgent Skill (SKILL.md)

Agent Skill (SKILL.md)

The StyleRef Agent Skill is an instruction layer that teaches any agent when to fetch StyleRef styles and how to apply them per tool. It pairs with the MCP server: the server provides the data and actions, the skill provides the judgment.

What it teaches

The skill (SKILL.md) gives an agent:

  • When to reach for a style — the user wants a consistent aesthetic or brand look for generated content, asks for consistency across generations, or names a style or a styleref.io link.
  • How to fetch one — prefer the MCP tools when available, otherwise the REST API; which format maps to which tool.
  • How to apply it per tool — placement rules for ChatGPT, Claude, Gemini, Midjourney, FLUX, and Stable Diffusion, and the STYLE.md convention for repos.
  • The honest-claims rules — never claim before/after improvement, never claim outputs are “the same across tools,” attribute the style. See below.

Install it

Add the skill from a skills marketplace (for example npx skills add). The folder name — styleref — is the skill name.

When to prefer it over MCP alone

  • MCP alone gives an agent the tools, but not the judgment about when and how to use them. An agent may fetch a style and then paraphrase it, or make claims the results don’t support.
  • The skill plus MCP adds the instruction layer: the agent knows when a request calls for a style, applies the spec verbatim, and describes results accurately.

Use the skill when you want consistent, correct StyleRef behavior across many conversations — not just the raw capability.

The honest-claims rules

The skill enforces the same rules these docs follow:

  • No before/after claims — there’s no unstyled baseline to compare against.
  • No “same across tools” claims — different models render the same spec differently. The accurate claim is consistency per generation within each tool, because every generation receives the same explicit constraints.
  • Attribute the style — keep the Generated by StyleRef.io line and canonical URL, and credit the author’s @handle for gallery styles.

Next steps

Last updated on
CLI (npx styleref)llms.txt & markdown endpoints