blog-mdx-authoring

Generate repo-ready Ylang Labs blog MDX posts with frontmatter, slugs, and asset scaffolds.

Updated Nov 1, 2024
One-click install
npx skills add https://github.com/artreimus/ylang-labs-blog --skill blog-mdx-authoring
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: blog-mdx-authoring
Source: https://github.com/artreimus/ylang-labs-blog/tree/main/.agents/skills/blog-mdx-authoring
Command: npx skills add https://github.com/artreimus/ylang-labs-blog --skill blog-mdx-authoring

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) and assets (resource) components.

What problem does it solve?

Creates consistent, repo-ready Ylang Labs blog MDX posts with the correct frontmatter, assets, references, and MDX layout conventions so your content is publishable and maintainable.

Core Features & Use Cases

  • Frontmatter and post-type scaffolding: Generates the required data/blogs/[slug].mdx structure and chooses the right layout (PostBanner, PostLayout, or PostSimple) for the post’s intent.
  • Slug, assets, and image conventions: Ensures kebab-case slug selection and standardizes image paths and filenames for card and header assets.
  • Research packet and provenance workflow: Sets up refs/[slug]/ reference/readme structures for citations, bibliographies, and source tracking, with optional integration for BibTeX workflows.
  • Calendar and editorial coordination: Preserves GitHub issue/project metadata when content is driven by the content calendar and aligns with the project’s writing and tagging standards.

Quick Start

Tell the skill to convert your blog topic and brief into a complete MDX file at data/blogs/your-slug.mdx, including frontmatter, the PostBanner scaffold, and the required assets folder structure for your images.

Frequently Asked Questions about blog-mdx-authoring

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

FAQPage Schema
How do I generate frontmatter and MDX scaffolds for a new blog post?

MDX scaffolding generates the required frontmatter and post layout structures by converting your title and brief into a repo-ready file at data/blogs/[slug].mdx. It automatically selects the appropriate layout, such as PostBanner or PostSimple, based on the post's intent.

How do I set up citations and references for an MDX blog post?

Reference setup organizes citations and source tracking by creating a refs/[slug]/ directory structure with readme files. This preserves provenance for your content and supports optional BibTeX workflows for bibliographic data integration.

Can I preserve content calendar metadata when creating an MDX blog post?

Calendar metadata preservation captures GitHub issue and project details when content is driven by a content calendar. It aligns the generated MDX frontmatter with editorial coordination standards and the project's writing and tagging conventions.

What's the best way to standardize image paths and assets for MDX blog authoring?

Asset setup standardizes image paths by enforcing consistent directory structures under public/static/images and standardizing filenames for card and header assets. This ensures all visual elements are correctly referenced and maintainable within the repository.

Why does my MDX blog post need a specific layout like PostBanner or PostLayout?

MDX layouts like PostBanner, PostLayout, and PostSimple define the structural presentation of your content based on its intent. Choosing the right scaffold during frontmatter generation ensures the post adheres to the blog-writing-guide standards and remains publishable.