article-style

Standardizes writing style, terminology, and headings for Japanese educational Markdown articles.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Educational articles written by multiple contributors drift in tone, terminology, and heading structure, producing inconsistent Japanese technical content. This Skill enforces a unified style guide for the Optimization Compass content corpus (content/methods, content/concepts) so every article follows the same voice, notation, and section conventions. ## Core Features & Use Cases - Style and Tone Rules: Enforces desu/masu form, one-idea-per-sentence writing, redundancy compression, and conditional phrasing for unguaranteed claims. - Terminology Normalization: Defines which terms stay in English (step, solver, gradient norm) versus Japanese (勾配, 目的関数, 凸性), plus canonical method names like BFGS and Nelder–Mead. - Heading Canonicalization: Provides a replacement table for drifting headings (e.g., Python例 → Python) and standard section orders for method, family, and concept articles. - Use Case: When revising an existing method article, apply the proofreading checklist to fix notation inconsistencies, normalize headings, update last_reviewed, and verify the first paragraph matches the frontmatter summary—without altering facts, code, math, or links. ## Quick Start Proofread the article at content/methods/bfgs.md using the article-style rules and fix any terminology or heading inconsistencies without changing technical facts.

Frequently Asked Questions about article-style

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

FAQPage Schema
How do I proofread a Japanese technical article for style consistency?▼

Apply the skill's proofreading checklist: verify the first paragraph matches the frontmatter summary, update last_reviewed, fix terminology per the English/Japanese notation tables, normalize headings with the replacement table, and confirm no facts, code, math, or links were changed.

What writing style rules apply to optimization method articles?▼

Method articles use desu/masu form, one idea per sentence, and a fixed section order: introduction matching the summary, mechanism explanation, suitable conditions, Python example, diagnostic values, failure and switching signs, then related links.

Which terms should stay in English versus Japanese in technical writing?▼

Implementation terms like step, solver, memory, gradient norm, and warm start stay in English ASCII lowercase. Core mathematical concepts like 勾配, 目的関数, 制約, and 凸性 are written in Japanese. Compound terms like gradient norm remain English.

Can I change article content when proofreading for style?▼

No. Proofreading must never alter technical facts, numbers, claim strength, code blocks, formulas, links, heading hierarchy, or callout semantics. Only summary and last_reviewed frontmatter fields may be updated; adding new facts requiring sources is forbidden.

How are headings normalized across Markdown articles?▼

A canonical replacement table maps drifting headings to standard forms, such as Python例 to Python and 失敗の兆候 to 失敗・切替の兆候. Combined sections use 向く条件・避ける条件, while split sections use the pair 向いている条件 and 避ける/切り替える条件.