ki-authoring

Standardize Markdown and TOML formatting and audit documents against authoring conventions.

Updated May 29, 2026
One-click install
npx skills add https://github.com/knowledgeislands/ki-agentic-harness --skill ki-authoring
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ki-authoring
Source: https://github.com/knowledgeislands/ki-agentic-harness/tree/main/skills/ki-authoring
Command: npx skills add https://github.com/knowledgeislands/ki-agentic-harness --skill ki-authoring

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires prettier, markdownlint, markdownlint-cli2, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill ensures consistency in authoring and formatting conventions across all Knowledge Islands skills, repos, and bases, reducing redundancy and improving maintainability.

Core Features & Use Cases

  • Markdown Formatting: Standardizes Markdown formatting for tables, footnotes, links, and code blocks.
  • TOML Formatting: Enforces consistent TOML formatting for .ki-config.toml files.
  • Audit and Conform: Provides tools to audit and conform documents to the established conventions.
  • Initialization: Initializes the authoring environment by setting up necessary files and configurations.
  • Refresh: Updates the authoring conventions to reflect changes in external tools and specifications.
  • Use Case: When writing or reviewing Markdown or TOML content, this Skill ensures adherence to the established style guide and conventions.

Quick Start

Run the ki:authoring:conform command to automatically format your Markdown and TOML files according to the standard conventions.

Frequently Asked Questions about ki-authoring

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

FAQPage Schema
How do I enforce consistent Markdown formatting across my documentation?

You can enforce consistent Markdown formatting by running the `ki:authoring:conform` command, which audits documents against established style guide rules and automatically conforms tables, footnotes, links, and code blocks to the standard conventions.

How do I standardize TOML configuration files for my project?

To standardize TOML configuration files, this Skill enforces consistent formatting specifically for `.ki-config.toml` files, auditing them against established conventions and automatically conforming them to ensure project-wide consistency and maintainability.

Do I need Prettier and markdownlint to audit and format my Markdown files?

Yes, you need Prettier, markdownlint, and markdownlint-cli2 installed as dependencies, because this Skill requires these external tools to execute its core formatting, auditing, and automatic conformance logic for Markdown and TOML files.

What is the best way to initialize an authoring environment for style guide compliance?

The best way to initialize an authoring environment is to use this Skill's initialization feature, which sets up the necessary configuration files and rules to enforce formatting and style guide compliance across your Markdown and TOML documents.

Why does my Markdown formatting break when external tool specifications change?

Markdown formatting can break when external tool specifications change, but you can run the Skill's refresh feature to update the authoring conventions, ensuring your formatting rules reflect the latest changes in external tools and specifications.

Can I audit Markdown and TOML files without automatically overwriting my original content?

Yes, you can audit Markdown and TOML files without overwriting content, because this Skill provides distinct audit and conform commands, allowing you to review documents against formatting rules before applying automatic changes.