Docs

Build an agent definition post on the Knowledge Layer site. One ability call, 8 sections, ~40 blocks. Proven on the Diagnostician agent.

1

ability call

8

sections

40

blocks

0

validation errors

What this SKILL builds: A complete agent definition post — badges, description, capability lanes table, permission constraints, behavioral rules, course prerequisite, structured output format, and related items. Third build in the series: landing page (10 calls) → module post (2 calls) → agent post (1 call).

Overview

This SKILL produces agent definition posts for knowledge.wickedevolutions.com. Each agent post follows the same structure: identity badges, a description of the agent’s role, a table of its operating lanes and key abilities, permission constraints, behavioral rules, any course prerequisites, a structured output format, and hand-picked related items.

The template (single-post.html) provides the page header, sidebar, breadcrumb, title, excerpt, category/tags, related query, post navigation, TOC rail, and footer. Content provides everything inside wp:post-content.

Data Requirements

Every agent post needs these fields before the build call. Collect them first — the build is a single ability call, so all data must be ready.

FieldWhere It GoesSource
TitlePost title fieldAgent name
ExcerptPost excerpt fieldOne-line agent description
CategoryTaxonomy assignment“Agents” category
TagsTaxonomy assignmentPermission level, lane tags
BadgesContent Section 1Permission + type + lane chips
DescriptionContent Section 2Agent role and purpose prose
Lanes tableContent Section 3Focus areas with key abilities
Permission levelContent Section 4Constraint statement + “why” callout
Behavioral rulesContent Section 5Operational guidelines list
Course requirementContent Section 6Prerequisite with card link
Output formatContent Section 7Report template as code block
Related itemsContent Section 84 hand-picked related entries

Block Map

The block map is the blueprint. It shows exactly how Gutenberg blocks nest, which attributes use preset slugs, and which use inline styles. Read it before writing any markup.

AGENT POST — 8 SECTIONS
═══════════════════════════════════════════

SECTION 1 — Badges
└── Group (section wrapper)
    └── Group (flex row, wrap, blockGap 8px)
        └── N× Paragraph (badge chip)
            preset: backgroundColor, textColor
            inline: fontSize 11px, textTransform, letterSpacing,
                    fontWeight 600, padding 4px/10px, radius 4px

SECTION 2 — Agent Description
└── Group (section wrapper)
    ├── Heading H2          preset: fontSize "large"
    └── Paragraph           preset: textColor "secondary", fontSize "medium"

SECTION 3 — Lanes
└── Group (section wrapper)
    ├── Heading H2
    ├── Paragraph           intro text
    └── Table               3×3 (Lane | Focus | Key Abilities)
        preset: fontSize "small"
        inline: hasFixedLayout
        <strong> for lane names · <code> for ability names

SECTION 4 — Permission Level
└── Group (section wrapper)
    ├── Heading H2
    ├── Paragraph           bold constraint statement
    └── Group (callout)
        preset: backgroundColor "green-tint"
        inline: border-left 3px green
        └── Paragraph       "Why read-only?" explanation

SECTION 5 — Behavioral Rules
└── Group (section wrapper)
    ├── Heading H2
    └── List (unordered)    7 items
        preset: textColor "secondary", fontSize "small"

SECTION 6 — Course Requirement
└── Group (section wrapper)
    ├── Heading H2
    ├── Paragraph           requirement statement
    └── Group (card)        green-tint/green-border, compact
        ├── Paragraph       linked title
        └── Paragraph       description

SECTION 7 — Output Format
└── Group (section wrapper)
    ├── Heading H2
    ├── Paragraph           intro text
    └── Code                structured report template

SECTION 8 — Related
└── Group (section wrapper)
    ├── Heading H2
    └── Columns (2) × 2 rows
        └── 4× compact glass card (title + description)

Badge Chip Patterns

Three color variants cover the badge use cases. Each is a Paragraph block with preset background/text colors and inline typography:

read-only

diagnostic

system

content

VariantbackgroundColortextColorUsed For
Greengreen-tintgreenPermission badges (read-only, read-write)
Purplepurple-tintpurple-lightType badges (diagnostic, publisher)
GhostghostsecondaryLane badges (system, content, structure)

Build Log

Proven on the Diagnostician agent (post 225, knowledge.wickedevolutions.com). One ability call produced the complete post.

content-create

site: wicked.knowledge · post_type: post · status: draft · title: “Diagnostician” · excerpt: set · content: all 8 sections

Block Type Counts

BlockCountNotes
wp:group148 section wrappers + badge row + callout + card + 3 inner
wp:heading81× H2 per section
wp:paragraph~22Badges, descriptions, callout, card content
wp:table13 rows, 3 columns, fixed layout
wp:list1Unordered, 7 items
wp:code1Report template
wp:columns22×2 related cards

Preset vs Inline Tally

~40

preset slugs

~35

inline styles

0

var() in inline

0

validation errors

Duplicating to Other Agents

The block structure stays identical — only text content changes. Badge color variants should match the agent’s characteristics.

  1. Duplicate the base post — Use content/duplicate on post 225, or create a new post with the same block structure via content-create.
  2. Swap the content — Change: title, excerpt, badges (different permission/type/lane), description, lanes table, permission level, behavioral rules, output format, related items.
  3. Assign taxonomy — Set the correct category and tags via taxonomies/assign-to-content.

Build series progression: Landing page: 10 calls, ~75 blocks (learning the system). Module post: 2 calls, ~30 blocks (applying lessons). Agent post: 1 call, ~40 blocks (knowledge compounded). The pattern is proven across three post types.

Build Page From Prototype

SKILL — The full 6-step workflow

Build Module Post

SKILL — 1-call module reference build

Diagnostician Agent

Agent — built using this SKILL

Block Theme Pitfalls

Gotchas — G1 attribute stripping, G2 separator


Related