publish-blog-post

Draft, prepare media for, and publish Quarto blog posts using site configuration.

Updated Sep 11, 2026
One-click install
npx skills add https://github.com/cameronbracken/waterology-research --skill publish-blog-post-cameronbracken
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: publish-blog-post
Source: https://github.com/cameronbracken/waterology-research/tree/main/skills/publish-blog-post
Command: npx skills add https://github.com/cameronbracken/waterology-research --skill publish-blog-post-cameronbracken

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Publishing a blog post involves many site-specific details—frontmatter, image sizes, preview commands, upload destinations, and credentials—that are easy to get wrong, causing broken media or failed deployments. This Skill guides the full drafting-to-deployment workflow using the current site's own configuration instead of assumptions. ## Core Features & Use Cases - Site-aware post preparation: Follows the site's post layout, frontmatter, media references, and preview/production URL mapping, with descriptive image alt text. - Media preparation and validation: Selects available image tools, checks pixel dimensions and aspect ratios after cropping, and confirms social-card format support separately from inline images. - Authorized upload and verification: Uses the configured upload command with correct MIME types, keeps credentials in the provider's credential store, and verifies served post and media URLs after deployment. - Use Case: You have written a Quarto post with several images. Use this Skill to crop and size the images per site requirements, run the preview and build commands, upload media to the configured destination, and verify the live URLs render correctly. ## Quick Start Use the publish-blog-post skill to prepare and publish my new Quarto post with its images to the site.

Frequently Asked Questions about publish-blog-post

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I publish a Quarto blog post with images?▼

Follow the site's post layout and frontmatter, prepare images to the required sizes and formats, run the configured preview and build commands, then upload media with the configured command and verify the live post and media URLs after deployment.

Why do images not render on my published blog post?▼

Media rendering failures usually come from wrong preview/production URL mapping, incorrect MIME types on upload, or unmet size and format requirements. Inspect the rendered post at expected viewing sizes and verify the served response after an authorized upload.

How should I handle credentials when uploading blog media?▼

Keep credentials in the provider's credential store or environment variables, never in site guidance or documentation. Use the configured upload command and destination, and only deploy after existing user authorization.

What image requirements should I check before publishing a post?▼

Check pixel dimensions and aspect ratio after cropping, and confirm the site's size and format requirements using available image tools. Confirm social-card format support separately from inline images, and supply descriptive alt text.

Can I use this publishing workflow without the waterology CLI?▼

Yes. If the CLI is unavailable, use the shared local preferences resolver with the publish-blog-post skill name, including common preferences and matching local guidance, instead of running waterology config context.