markdown-formatting
Use this skill whenever creating or editing any markdown file. Do not wait for an explicit request — if a markdown file is being created or edited, this skill applies.
How do I install this agent skill?
npx skills add https://github.com/naykel76/skills-and-guidelines --skill markdown-formattingIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The skill defines markdown formatting rules and syntax for the Torchlight highlighter. It contains no malicious code, data exfiltration patterns, or security vulnerabilities.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
What does this agent skill do?
General
- No table of contents unless specifically requested.
- Don't join two thoughts mid-sentence with an em dash or a colon. Use a new sentence, or a comma with a linking word ("because", "so").
Code Blocks
All code blocks must include a language tag and a Torchlight flag.
| Flag | Description |
|---|---|
+code | Source code only (syntax highlighted) |
+demo | Preview + code (always visible) |
+demo-folded | Preview + code + collapsible |
Other flags (+preview, +collapse, output) exist but are less common — only use when requested.
Language Tags
| Use For | Tag |
|---|---|
| Directory trees, shell commands | ```bash +code |
| Blade templates | ```html +code-blade |
Demo-Folded Attributes
When using +demo-folded, apply demo attributes intentionally:
class="..."— outer demo wrapper stylingpreview-class="..."— preview-only layout or styling
Example opening tag:
```html +demo-folded class="bx" preview-class="grid gap lg:cols-3"
<div class="example">Content here</div>
Horizontal Rules
Use 80 hyphens as a visual section separator in long documents when a --- thematic break is not appropriate:
--------------------------------------------------------------------------------
Lists
- Use hyphens
-for unordered lists - Use
1.2.for ordered steps - 4-space indentation for nested items
Tables
Standard GitHub Flavored Markdown. Keep column separators aligned.
| Column | Type | Nullable | Default |
|---|---|---|---|
| id | bigint | No | AUTO |
| name | varchar(255) | No | - |
Linting
- Blank line before and after headings, code blocks, and lists
- No trailing spaces
- Single blank line between sections — not double
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/naykel76/skills-and-guidelines/markdown-formatting">View markdown-formatting on skillZs</a>