guide-authoring

Creates and revises Microlift documentation guides from API parameter references.

142|31|Updated Jul 13, 2017
One-click install
npx skills add https://github.com/microlinkhq/www --skill guide-authoring
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: guide-authoring
Source: https://github.com/microlinkhq/www/tree/main/.cursor/skills/guide-authoring
Command: npx skills add https://github.com/microlinkhq/www --skill guide-authoring

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you create and revise Microlink guide documentation that matches the API accurately while staying workflow-first and easy to scan.

Core Features & Use Cases

  • Guide-to-API Alignment: Systematically translate API parameter knowledge into user-facing workflows without inventing undocumented shapes.
  • House-Style Consistency: Follow the existing screenshot guide quality standards for tone, depth, and cross-linking.
  • Workflow-First Structure: Build hub pages and subguides around user decisions (e.g., JSON vs embed, viewport vs element, fresh vs cached) rather than parameter catalogs.
  • Shared Pattern Reuse: Keep caching, private pages, and troubleshooting slim by linking to shared common pages instead of duplicating them.

Quick Start

Ask the AI to help you draft a new utility guide by mapping the utility’s API parameters into a small set of workflow pages under src/content/docs/guides, using the screenshot guide as the baseline and linking shared caching/private-page/troubleshooting patterns where applicable.

Frequently Asked Questions about guide-authoring

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

FAQPage Schema
How do I translate API parameter references into workflow-first documentation?

To translate API parameter references into workflow-first documentation, you map user decisions like JSON versus embed or fresh versus cached into structured guide sets, ensuring syntax, defaults, and response fields match authoritative docs without duplicating shared patterns.

What is the best way to structure technical writing for API alignment in MDX guides?

The best way to structure technical writing for API alignment in MDX guides is to organize hub pages and subguides around user decisions rather than parameter catalogs, strictly reading API parameter pages and applying house-style screenshot baselines for editorial consistency.

How do I convert parameter-by-parameter pages into runnable documentation guides?

To convert parameter-by-parameter pages into runnable documentation guides, you restructure the content by user workflows, cross-link shared caching and troubleshooting pages, and verify that stable URLs, syntax, and plan gating match the authoritative API documentation.

Does this approach support maintaining editorial consistency across multiple utility guides?

Yes, this approach supports maintaining editorial consistency across multiple utility guides by enforcing strict reading of the guides index, shared pattern pages, and MDX conventions, ensuring tone, depth, and cross-linking match existing screenshot guide quality standards.

When should I avoid duplicating shared patterns like caching and private pages in technical docs?

You should avoid duplicating shared patterns like caching and private pages in technical docs when adding new utility guides, instead linking to shared common pages to keep the documentation slim, workflow-first, and easy to scan.

Why do my Microlink docs need to match API parameter shapes exactly during guide authoring?

Your Microlink docs need to match API parameter shapes exactly during guide authoring to prevent inventing undocumented shapes, ensuring that workflow-first documentation remains runnable, accurate, and aligned with authoritative API parameter references.