Validate Block Markup

Validate, diagnose, or repair standalone serialized WordPress Gutenberg block markup built from core blocks, using a pinned Node.js runtime. Use when the user explicitly asks to validate, check, lint, or debug block markup or `<!-- wp:... -->` block comments, reports an invalid block, "unexpected or invalid content", or an "Attempt Block Recovery" prompt, or is about to paste markup into the WordPress Code Editor or assign it to post_content. Scope is standalone, cross-site-portable core block markup only; site-specific, theme-specific, dynamic, plugin, and third-party block content are out of

23 stars 4 forksWriting & Content Plugin marketplace

Install

Claude Code plugin
/plugin marketplace add nathanonn/agent-skills

The repo is a Claude Code plugin marketplace. Run /plugin afterwards to pick the plugin that includes this skill.

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add nathanonn/agent-skills --skill validate-block-markup
Manual install
git clone --depth 1 https://github.com/nathanonn/agent-skills.git /tmp/agent-skills
mkdir -p ~/.claude/skills
cp -r /tmp/agent-skills/plugins/validate-block-markup/skills/validate-block-markup ~/.claude/skills/validate-block-markup

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# Validate Block Markup

Check serialized block markup against the WordPress core block library running in Node.js. Treat structural validity and cross-site portability as separate verdicts, and treat review and repair as separate jobs.

Verdicts are produced against the core block definitions shipped with **WordPress 7.0.2**. Always tell the user which snapshot the verdict came from.

## Requirements

- Node.js 20.10 or newer, with `npm` on `PATH`.
- **First run installs a runtime into this skill's own directory**: `npm ci` of 350 packages, about 545 MB on disk, roughly 25 seconds, and it needs npm registry access. Later runs are offline and instant. `--help` and `--version` answer immediately and install nothing.
- The install never touches the user's project — no edits to their `package.json`, no lockfile changes, nothing written to a project-level `node_modules`. Everything lands in `<skill-directory>/node_modules/`.
- That distinction matters less than it sounds: the common `npx skills add` layout puts this skill *inside* the user's repository, so those 545 MB land in their repo tree. Say so before the first run. The skill ships a `.gitignore` covering `node_modules/` and rewrites it before installing if it went missing, so git stays clean without the user doing anything.
- Most of the installed bytes are `@wordpress/*` packages, licensed GPL-2.0-or-later. The skill's own code is MIT.
- No WordPress, PHP, wp-env, Docker, Playwright, or browser is required.
Read the full skill on GitHub

Details

Skill name
validate-block-markup
Path
plugins/validate-block-markup/skills/validate-block-markup/SKILL.md
License
MIT
Repo updated
11 November 2026

FAQ

What does the Validate Block Markup skill do?

Validate, diagnose, or repair standalone serialized WordPress Gutenberg block markup built from core blocks, using a pinned Node.js runtime. Use when the user explicitly asks to validate, check, lint, or debug block markup or `<!-- wp:... -->` block comments, reports an invalid block, "unexpected or invalid content", or an "Attempt Block Recovery" prompt, or is about to paste markup into the WordPress Code Editor or assign it to post_content. Scope is standalone, cross-site-portable core block markup only; site-specific, theme-specific, dynamic, plugin, and third-party block content are out of

How do I install the Validate Block Markup skill?

Claude Code plugin: /plugin marketplace add nathanonn/agent-skills. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Validate Block Markup popular?

It lives in nathanonn/agent-skills, which has 23 GitHub stars and 4 forks.

Related skills

Ask First

23

nathanonn/agent-skills

Ask clarifying questions before executing tasks. Use this skill whenever the user says "ask me questions first", "clarify before doing", "ask before you start", invokes /ask-first, or wants Claude to gather requirements through Q&A before taking action. Also trigger when the user provides a task prefixed with "ask:" or says things like "I need help figuring out how to..." or "help me think through...". This skill ensures nothing is assumed — Claude asks until 95% confident, then executes.

Productivity & Notes

CLI Spec to Goal

23

nathanonn/agent-skills

Convert a Node.js CLI tool specification (even a vague one) into a Codex /goal-ready bundle — GOAL.md, VERIFY.md, PROGRESS.md inside goals/<slug>/ — with AI-agent-friendly patterns (--json, stdout/stderr separation, exit codes, structured errors, TTY detection, --dry-run) baked into every goal. Asks clarifying questions in focused batches (each with options + recommendation + reasoning), reaches 95% confidence, optionally scaffolds a missing CLI project (bin/, src/, package.json, AGENTS.md, CLAUDE.md behavioral snippet), and emits a tailored /goal command. Handles both new CLIs and adding comm

Software Development

Codex Imagegen

23

nathanonn/agent-skills

Generate images such as featured images, illustrations, diagrams, thumbnails, and blog visuals with the Codex CLI built-in $imagegen skill, save them into the current project, and safely clean this run's generated-images cache. Use when the user asks to generate, create, or make an image, picture, illustration, featured image, thumbnail, visual asset, image variants, AI artwork, or explicitly asks to use Codex image generation. Do not use for screenshots, charts rendered from data, ASCII diagrams, or editing existing images.

Images, Video & Audio

Advisor Capability Preflight

24

forcedotcom/partner-ecosystem-agentic-kit

Check and configure documentation capabilities before an ISV Partner Advisor interaction. Use when the advisor starts, when Salesforce Docs MCP or official-documentation access may be missing, when a customer asks to install or approve documentation tools, or when the active harness changes.

Writing & Content

Handoff Doc

23

nathanonn/agent-skills

Write or update a session handoff doc that lets a future session (Claude or human) resume work without re-reading the whole transcript. Use this skill whenever the user asks to "write a handoff", "create a handoff doc", "update the handoff", "write a doc so the next session can continue", "session handoff note", "hand this off", or points at a path and says to capture where things stand. The user only needs to give the destination file path — the content is distilled from the current session. Do NOT use for general project documentation, READMEs, API docs, code comments, or changelogs.

Writing & Content

Coda

33

dvcrn/openclaw-skills-marketplace

General-purpose Coda document manager via REST API v1. Supports listing/creating/updating/deleting docs, managing tables/rows/pages, triggering automations, and exploring doc structure. Requires CODA_API_TOKEN environment variable. Delete operations require explicit confirmation; publishing and permission changes require explicit user intent.

Writing & Content17

Browse the most popular Claude skills, all writing & content skills, or write your own with the skills generator.