agentic-builder-lab

name	Agentic Builder Lab
description	Convert a single build session into MDX build-log entry, LinkedIn draft, demo brief, Mermaid diagram, and a reusable prompt. Use when logging a public build or running the content flywheel for the /agentic-builder-lab and /build pages on frankx.ai.
version	0.1.0
triggers	["log a build","build session log","agentic-builder-lab","/build-log"]
inputs	{"required":["build_name","status","stack","key_learning"],"optional":["demo_url","repo_url","day_number","outcome_metric","slug"]}
outputs	["content/builds/[slug].mdx","drafts/linkedin/[slug].md","drafts/demos/[slug]-brief.md","drafts/diagrams/[slug].mmd","skills/projects/agentic-builder-lab/resources/prompt-pack/[slug].md"]
dependencies	["frankx-brand"]
voice_override	resources/voice-spec.md

Agentic Builder Lab

One build session, five artifacts. This skill takes the receipts from a real build and produces the content stack that ships to frankx.ai.

The flywheel

A single build session produces:

1. MDX build-log entry — long-form record at content/builds/[slug].mdx (rendered by /agentic-builder-lab/[slug] on the frankx.ai site).
2. LinkedIn draft — short post that points back to the build log.
3. Demo brief — 60-90s video script with shot list.
4. Mermaid diagram — the architecture or agent flow, ready to embed.
5. Reusable prompt — one artifact from the build added to the prompt pack so the next builder can copy it.

The point is leverage. One session, five published surfaces. No artifact is decorative — each one points to the next.

Voice override

This skill depends on frankx-brand, but overrides its default studio voice for every output it produces. The override is loaded from resources/voice-spec.md after frankx-brand is loaded, so the override wins.

The override rules in short:

• Technical authority. Results first, claims never.
• No spiritual, consciousness, or transformation language.
• No exclamation marks. No hype adjectives.
• Lead with what was built, the tool, and the outcome.
• Show failures honestly — humility is on-brand.

Banned terms (lint at exit): soul, awaken, transformation, alignment, journey, intentional, sacred, energy, vibration, frequency, studio (as metaphor), elevate (as metaphor), unlock (as metaphor).

Encouraged terms: architect, agent, verification, orchestration, stack, primitive, harness, scaffold, ship, repo, PR, eval.

Full spec: see resources/voice-spec.md.

How the skill runs

Step 1 — Load voice override

1. Read resources/voice-spec.md.
2. Treat its rules as binding for every artifact this skill writes.
3. If frankx-brand was loaded earlier in the session, its studio voice is now suppressed for outputs of this skill.

Step 2 — Collect inputs

Required fields:

• build_name — short label (becomes the title).
• status — one of live, shipping, wip, paused, archived.
• stack — list of tools and what each one does in the build.
• key_learning — the one thing the builder would tell another builder.

Optional fields:

• demo_url — live demo URL.
• repo_url — public repo.
• day_number — if this is part of a build-in-public counter.
• outcome_metric — one quantifiable result (latency, cost, users, PRs merged).
• slug — kebab-case slug. If not provided, derive from build_name.

If any required field is missing, ask the user for it in one batched message. Do not invent values. Do not proceed until all four required fields are filled.

Step 3 — Generate the five artifacts

Load each template from resources/ and fill it in:

Output	Template	Destination
MDX build log	resources/mdx-template.md	content/builds/[slug].mdx
LinkedIn draft	resources/linkedin-template.md	drafts/linkedin/[slug].md
Demo brief	resources/demo-brief-template.md	drafts/demos/[slug]-brief.md
Mermaid diagram	resources/diagram-prompt.md	drafts/diagrams/[slug].mmd
Prompt pack entry	resources/prompt-pack-conventions.md	skills/projects/agentic-builder-lab/resources/prompt-pack/[slug].md

The MDX file is the canonical artifact. The other four reference it.

Step 4 — Lint

After all files are written, grep each one for banned terms. If any banned term appears, rewrite that artifact before exit. Suggested check:

# studio, elevate, unlock are banned as metaphors only. Literal usage
# ("recording studio", "elevate floor 3", "unlock the door") is fine —
# review each hit against resources/voice-spec.md before rewriting.
BANNED="soul|awaken|transformation|alignment|journey|intentional|sacred|energy|vibration|frequency|studio|elevate|unlock"
grep -InE "\\b($BANNED)\\b" \
  content/builds/[slug].mdx \
  drafts/linkedin/[slug].md \
  drafts/demos/[slug]-brief.md \
  drafts/diagrams/[slug].mmd \
  skills/projects/agentic-builder-lab/resources/prompt-pack/[slug].md

Lint must pass on a clean exit.

Step 5 — Report

Print the five file paths and a one-line summary of each. Do not push, do not commit. The caller decides what to ship.

Example invocation

User: /build-log

> build_name: Antigravity Codex Bridge
> status: shipping
> stack:
>   - Antigravity: agent harness
>   - Codex CLI: parallel verification
>   - Claude Code: PR review
>   - Vercel: deploy
> key_learning: Two agents disagreeing on the same PR catches more bugs than one agent running twice.
> day_number: 14
> outcome_metric: 3 PRs shipped in one afternoon
> demo_url: https://example.com/demo
> repo_url: https://github.com/frankxai/example

Skill produces:

content/builds/antigravity-codex-bridge.mdx
drafts/linkedin/antigravity-codex-bridge.md
drafts/demos/antigravity-codex-bridge-brief.md
drafts/diagrams/antigravity-codex-bridge.mmd
skills/projects/agentic-builder-lab/resources/prompt-pack/antigravity-codex-bridge.md

Files in this skill

agentic-builder-lab/
├── SKILL.md                                 ← this file
└── resources/
    ├── voice-spec.md                        ← voice override (load first)
    ├── mdx-template.md                      ← build-log MDX scaffold
    ├── linkedin-template.md                 ← 9 LinkedIn post combos
    ├── demo-brief-template.md               ← 60-90s video brief
    ├── diagram-prompt.md                    ← 3 Mermaid diagram templates
    ├── prompt-pack-conventions.md           ← how to add a prompt
    └── prompt-pack/
        └── example-agents-md.md             ← starter prompt: AGENTS.md template

Notes for the model running this skill

• Read voice-spec.md before generating any artifact. Re-check it before the lint step.
• If the user already has a build log at content/builds/[slug].mdx, ask whether to update it or write a new entry with a different slug.
• The prompt pack is cumulative — never overwrite an existing entry without asking.
• The MDX frontmatter must validate against the schema in mdx-template.md. If any field is missing, fall back to null, not an empty string.