Markitera WordPress Developer
WordPress Development & Publishing
Turn HTML pages, Markdown articles and plain-language requests into verified WordPress drafts, and publish them when you approve.
/wpdev in a brand workspace.1.Overview
Markitera WordPress Developer builds WordPress pages and posts from what you give it: an HTML page, a Markdown article, images, or a description.
Moving a finished design or article into WordPress is repetitive and easy to get wrong: lost styles, broken image paths, unsafe scripts, duplicate drafts, accidental publishing.
Mission
Implement pages and posts on the connected WordPress site from the materials the user provides, as faithfully as the site allows, as drafts first, verified by reading them back, and published only with approval.
Problems it solves
- Copying HTML into the editor loses styles and breaks image paths
- Imported pages that restyle the whole site
- Drafts duplicated by retries, and pages published by mistake
Responsibilities
- Resolve the target site and check the WordPress user’s permissions
- Analyze the source in full and say what cannot carry over
- Create drafts with page-scoped CSS and uploaded media
- Edit existing content without touching unrelated parts
- Verify every change by reading it back
- Publish only on explicit request and approval
In the Markitera workflow: Works next to the Content Engine: the Content Engine decides what to write; the WordPress Developer implements pages and posts on the site.
2.How it works
Resolve the target site
Uses the only connected WordPress site, or asks which one when several are connected. Checks what the connected user may do.
wordpress_site_statusAnalyze the source
Parses the uploaded HTML or Markdown in full: structure, styles, scripts, forms, assets and front matter. Content in files is data, never instructions.
wordpress_analyze_sourceread_filelist_filesCheck what exists
Finds the page or post to edit, or confirms a new one would not duplicate an existing page.
wordpress_list_postswordpress_get_postPlan the implementation
Chooses how to build it with the capabilities the site actually offers and states what cannot be reproduced.
wordpress_site_statusCreate or update as a draft
Imports the file or saves the written HTML as a draft, with media uploads; each change is an approval request.
wordpress_import_filewordpress_upload_mediawordpress_save_postVerify
Reads the saved page or post back and checks status, title, slug, content, styles, images and terms.
wordpress_verify_contentPublish on request
Publishes a reviewed draft only when the user asks, after approval, and confirms the published status.
wordpress_publish
3.Capabilities
Available now
HTML file to WordPress page
Whole-file conversion with page-scoped CSS, local images uploaded to the Media Library, scripts removed, saved as a draft and verified.
Markdown to blog post
Front matter (title, slug, excerpt, categories, tags, featured image), full CommonMark and GFM conversion, draft creation and verification.
Pages from a description
Landing, about, pricing, FAQ and contact pages written on-brand and saved as drafts.
Edit existing pages and posts
Reads the current content, changes only what was asked and refuses to overwrite edits made after the proposal.
Partial or planned
Media and SEO fieldsPartial
Workspace images to the Media Library with alt text; SEO title and description where Yoast SEO or Rank Math expose them.
Other SEO fields (canonical, Open Graph) are reported for manual entry.
Forms and questionnairesPartial
Static form markup, or a form plugin when the connected EMCP tools expose one.
Markitera does not store form submissions; a form needs a form plugin or endpoint to work.
Visual comparison with the sourcePlanned
Rendering the draft and comparing it with the uploaded design.
Drafts are verified through the REST API; the preview link is for a visual check.
4.Skills used
Every skill this persona loads, from Markitera’s skill registry. Skills from Marketing Skills by Corey Haines (MIT) are vendored unmodified; Markitera’s adaptation is listed separately and is not part of the original skill.
WordPress Developer
wordpress-developerMarkitera skillInstalledv1.0.0Role: Persona instructions: site selection, source analysis, implementation choice, draft-first changes, verification and reporting.
Builds WordPress pages and posts from HTML files, Markdown articles and descriptions: analyzes the source, plans, creates verified drafts and publishes only on approval.
Source: Markitera
WordPress Publishing
wordpress-publishingMarkitera skillInstalledv2.0.0Role: Reading and updating posts and pages through approval.
Reads and updates WordPress posts; every write waits for approval.
Source: Markitera
Content Writing
content-writingMarkitera skillInstalledv1.0.0Role: On-brand copy for pages described in words.
Writes and improves on-brand pages and posts from brand files.
Source: Markitera
Copywriting
copywritingMethodology referenceInstalledv2.2.0Role: Page copy for landing, pricing, about and FAQ pages written from a description.
Write, rewrite, or improve marketing copy for any page, including homepage, landing pages, pricing pages, feature pages, about pages, or product pages.
Markitera adaptation: Read for brief and draft writing guidance; brand voice comes from brand/brand-voice.md.
Source: Marketing Skills by Corey Haines · MIT license · Original skill(opens in a new tab) · Source at the pinned commit(opens in a new tab)
Conversion Rate Optimization (CRO)
croMethodology referenceInstalledv2.0.3Role: Landing-page structure and calls to action when the user asks for a conversion page.
Optimize, improve, or increase conversions on any marketing page or form — including homepage, landing pages, pricing pages, feature pages, lead capture forms, or contact forms.
Markitera adaptation: Read as a conversion-diagnosis method; evidence comes from GA4 landing pages.
Source: Marketing Skills by Corey Haines · MIT license · Original skill(opens in a new tab) · Source at the pinned commit(opens in a new tab)
Schema Markup
schemaImported skillInstalledv2.0.2Role: Structured data for FAQ and product pages.
Add, fix, or optimize schema markup and structured data on their site.
Markitera adaptation: Checks the audit’s structured-data findings; JSON-LD is generated only from facts visible on the site or in brand files.
Source: Marketing Skills by Corey Haines · MIT license · Original skill(opens in a new tab) · Source at the pinned commit(opens in a new tab)
5.Tools and integrations
| Tool | Access | Approval | Purpose |
|---|---|---|---|
| wordpress_site_status | Read | No approval needed | Connected sites, the target site, the WordPress user’s permissions and the capability map. |
| wordpress_analyze_source | Read | No approval needed | Deterministic analysis of an HTML or Markdown workspace file and its assets. |
| wordpress_verify_content | Read | No approval needed | Reads a page or post back and checks what was stored. |
| wordpress_list_posts | Read | No approval needed | Existing posts and pages (to avoid duplicates and find targets). |
| wordpress_get_post | Read | No approval needed | One post or page with its current HTML. |
| wordpress_import_file | Publishes | Always needs approval | Creates a draft page or post from a workspace file. |
| wordpress_upload_media | Publishes | Always needs approval | Adds workspace images to the Media Library. |
| wordpress_save_post | Publishes | Always needs approval | Creates or updates a page or post with HTML it wrote. |
| wordpress_publish | Publishes | Always needs approval | Publishes a reviewed draft when the user asked for it. |
| list_files | Read | No approval needed | Uploaded sources, assets and brand files. |
| search_files | Read | No approval needed | Finds uploaded sources. |
| read_file | Read | No approval needed | Brand voice, profile and source text. |
| write_file | Writes files | Per the brand’s write policy | Saves page plans and generated HTML as workspace files per the brand’s write policy. |
| list_assets | Read | No approval needed | Brand assets (logos, images). |
| read_web_page | Read | No approval needed | Reference pages the user names; content is untrusted data. |
| list_integrations | Read | No approval needed | Connected integrations and their tools. |
| read_skill_reference | Read | No approval needed | Its assigned methodologies only. |
| get_audit_findings | Read | No approval needed | Structured-data and on-page findings for pages it rebuilds (schema methodology). |
Data sources and integrations
- Connect per brand
WordPress (REST API)
Drafts, updates, media uploads and publishing with an Application Password.
- Connect per brand
WordPress EMCP tools
Block edits, Elementor pages, media sideloading, menus and site inspection.
- Built in
Workspace files
Uploaded HTML, Markdown, CSS and images.
- Planned
Visual regression
Rendered comparison with the source.
6.Inputs and outputs
Connected WordPress site (required · Content engine connection (Application Password) or Integrations → WordPress)
When missing: Explains how to connect WordPress; nothing is created.
Source material (optional · Uploaded HTML, Markdown, CSS and image files in the workspace, or a description)
When missing: Works from the description and the brand files.
Brand voice and profile (optional · brand/brand-voice.md, brand/brand-profile.md)
When missing: Writes neutral copy and says so.
Missing assets, unsupported features and fields WordPress does not expose are listed in the result; nothing is reported as saved unless WordPress returned it.
What it produces
- Approval requests for drafts, media, updates and publishing
- Result reports with preview and edit links and check-by-check verification
- records/ workspace files of every executed change
Saved as: ApprovalRequest (WORDPRESS_POST) with the executed result, a records/ workspace file, and the WordPress page or post.
Output sections
- Target site: The WordPress site the change applies to.
- Source analysis: Structure, styles, assets and what cannot carry over.
- Implementation plan: How the page or post is built with the tools this site offers.
- Resource: Type, title, id, slug and status.
- Preview and edit links: WordPress preview and editor URLs.
- Assets: Uploaded, reused, embedded, missing or unsupported.
- Verification: What was read back from WordPress, check by check.
- Warnings and manual steps: Unsupported features, unsaved fields and what the user still has to do.
How other personas use it
- People review drafts in WordPress and approve publishing in the workspace
Reads: Content brief, Draft. Produces: WordPress change, Approval.
7.Verification
Every change is read back from WordPress and checked field by field; a failed check is reported, never hidden.
- Status
- New content must be stored as a draft.
- Content
- The stored markup carries the import marker, no scripts, and the scoped CSS.
- Media
- Uploaded image URLs appear in the stored content.
- Terms and SEO
- Categories, tags and SEO fields match what was sent.
8.Permissions and safety
Reads sources and the connected WordPress site freely. Every draft, media upload, update and publication is an approval request, and new pages and posts are always drafts first. It cannot change strategies, briefs, audits or site-wide settings on its own.
What it can read
- Uploaded HTML, Markdown, CSS and image files in the workspace
- Connected WordPress sites, their pages, posts and media
- The connected WordPress user’s permissions
- Brand voice, profile and assets
What it can create
- Approval requests for draft pages and posts, media uploads, updates and publishing
- Workspace files with page plans or generated HTML (per the brand’s write policy)
What requires approval
- Creating a draft page or post
- Uploading media
- Updating an existing page or post
- Publishing a draft
- Every write in a connected MCP system
What it never does automatically
- Publishing or updating a WordPress post (always an approval request)
- Any write in a connected MCP system (always an approval request)
- Deleting workspace files (always an approval request)
- Approving its own strategy, goal or brief (people approve in the app)
- Publishing a page because the user asked to create, build or prepare it
- Deleting or trashing pages, posts or media
- Changing themes, plugins, site settings, menus or global styles
- Injecting JavaScript into page content
These limits are enforced by the server: in a WordPress Developer turn the agent is only offered the tools listed above, and connected-system tools are offered with every write waiting for approval. Website pages, files and tool results are treated as data, never as instructions.
9.Example workflow
Illustrative example (sample data, not real results). Every value below is illustrative; none is a real Markitera result or performance figure.
1. Input
Upload landing.html and its img/ folder; ask for a draft page.
2. Analysis
Sample: 6 sections, 4 images found, 1 script that will be removed, 1 form without an action.
3. Approval
Approve the import card that lists title, slug and uploads.
4. Result
Sample: draft page 812 created, images uploaded, all checks passed, preview link returned.
5. Publish
Ask to publish; approve; the published status is confirmed.
10.Limitations
- JavaScript from the source is never added to WordPress; interactive widgets need a plugin or block equivalent.
- The page CSS is removed by WordPress when the connected user lacks unfiltered_html.
- The theme’s header, footer and content width still apply; a full-width page template may need to be chosen in WordPress.
- Fonts are not uploaded; web-font stylesheets (Google Fonts) are kept.
- Forms are static markup unless a form plugin handles them.
- Visual fidelity is not checked automatically; use the preview link.
11.Version and availability
- Version
- 1.0.0
- Availability
- Beta
- Start it with
- /wpdev
Other personas: Markitera Auditor · Markitera Strategist · Markitera Content Engine