CtrlK
BlogDocsLog inGet started
Tessl Logo

markdown-format

Format a Markdown file to match Liferay conventions — frontmatter order, Title Case headings, braced shell variables, long-form CLI flags, and professional prose. Use when the user asks to format, clean up, polish, or copy-edit a Markdown file destined for the Liferay repository.

Invalid
This skill can't be scored yet
Validation errors are blocking scoring. Review and fix them to unlock Quality, Impact and Security scores. See what needs fixing →
SKILL.md
Quality
Evals
Security

Markdown Formatter

Apply Liferay Markdown conventions to the target file so its structure, casing, and prose are consistent and professional.

Input

When ${ARGUMENTS} is a path to a Markdown file, format that file. When no path is supplied, ask the user which file to format.

Workflow

Read the File

Read the target file in full before making changes. Note the frontmatter, headings, code blocks, and any conventions already in use.

Apply the Conventions

Apply all conventions defined in .claude/rules/markdown-style.md. Work through each category in order. Fix each category before moving to the next.

Validate

Reread the file after the pass and confirm every check still holds.

Report

Summarize the changes, grouped by category (frontmatter, headings, prose, shell, lists).

Repository
liferay/liferay-portal
Last updated
First committed

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.