add-content-article

Adds or improves method and concept articles for canonical optimization entities with validation.

Updated Jul 13, 2026
One-click install
npx skills add https://github.com/mryk814/optimization-compass --skill add-content-article-mryk814
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: add-content-article
Source: https://github.com/mryk814/optimization-compass/tree/main/.agents/skills/add-content-article
Command: npx skills add https://github.com/mryk814/optimization-compass --skill add-content-article-mryk814

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? It guides contributors through adding or enriching method and concept articles in the Optimization Compass knowledge base while keeping content consistent with canonical entities and passing repository validation gates. ## Core Features & Use Cases - Canonical entity verification: Confirms the target entity exists in generated indexes (content.json, sources.json) before writing, stopping if the entity is missing. - Article authoring workflow: Mirrors frontmatter from the nearest existing article in content/methods or content/concepts and marks incomplete work as draft. - Density and validation checks: Runs the method content density report and the optimization-compass validate content / tier-a commands before submission. - Use Case: A contributor wants to document an existing optimization method that lacks an article; the skill walks them through entity lookup, article creation, density checks, and PR validation. ## Quick Start Add a new method article for an existing canonical entity and validate it with the optimization-compass content checks.

Frequently Asked Questions about add-content-article

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

FAQPage Schema
How do I add a new method article to Optimization Compass?▼

First confirm the entity exists in the canonical generated indexes (content.json, sources.json). Then mirror the frontmatter of the nearest existing article in content/methods, write the new file, and run the content validation command.

How do I validate content changes in Optimization Compass?▼

Run uv run optimization-compass validate content for standard checks. The PR gate requires uv run optimization-compass validate tier-a, and tier-b is recommended when relations or generated indexes change.

What happens if the entity has no canonical entry yet?▼

The workflow stops immediately. A missing article does not mean a missing entity, but if the entity itself is absent from canonical data, you must follow the canonical addition recipe (Recipe F) instead of writing an article.

When should an article be marked as draft status?▼

Mark the article with status: draft when its relations or sources are incomplete. This signals the content is not yet fully traceable and should not be treated as finished.

How do I check method article density requirements?▼

Run the method_content_density_report.py script with an explicit temporary output path, since the default output overwrites files in the docs directory. Compare results against the density floor in docs/method-content-density.md.