n4m3z/MarkdownConventions
skills/MarkdownConventions/SKILL.md
Markdown authoring and linting conventions for forge — fence tags, table alignment, link paths, reference-style labels, README language switchers, and the Linting workflow. USE WHEN editing any markdown file, or invoking lint.
$ install --global
skillsauthnpx skillsauth add n4m3z/forge-core MarkdownConventionsInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: May 15, 2026, 6:05 AM169.7s9 files scanned
SKILL.md
- name:
- MarkdownConventions
- version:
- 0.1.0
- description:
- Markdown authoring and linting conventions for forge — fence tags, table alignment, link paths, reference-style labels, README language switchers, and the Linting workflow. USE WHEN editing any markdown file, or invoking lint.
- argument-hint:
- [path to markdown file]
MarkdownConventions
Hub for forge's markdown conventions and the linting workflow. Each companion below holds one convention; Claude reads the relevant companion when the current task calls for it.
Workflow
For a full lint pass on a file: see Linting.md. That workflow reads the file, applies all conventions below, and writes the corrected version after confirmation.
Conventions
- MarkdownCodeFence.md — every fenced code block has a language tag; prefer
shoverbash - TableAlignment.md — tables must have column-aligned pipes
- MarkdownLinks.md — use literal spaces in link paths, never
%20 - MarkdownReflinks.md — reference-style link labels use mnemonic abbreviations, not numbers
- SourceCitations.md — cite origins for factual data points (numbers, dates, limits)
- ReadmeLanguageSwitcher.md — multilingual README switcher pattern
Constraints
- Never modify YAML frontmatter content during a lint pass
- Never modify content inside fenced code blocks or inline code
- Preserve Obsidian-specific syntax (wikilinks, embeds, callouts,
%% %%comments, dataview blocks)
Related Skills
n4m3z/Wtf
development
VerifiedTrustedCommunity
Reactive correction and root-cause fix. USE WHEN something went wrong, user is frustrated, demands a correction, says wtf, what the hell, why did you, that's wrong, this is broken, no not that, stop. Executes the immediate fix, then hunts the upstream artifact that caused it and creates a corrective change.
4SKILL.mdUpdated May 28, 2026
n4m3z/ResearchTopic
development
VerifiedTrustedCommunity
Decompose a research question into sub-queries, spawn parallel WebResearcher agents per angle, synthesize findings with citations and explicit confidence. USE WHEN the user asks to research, investigate, look online, look up, dig into, find sources, gather evidence, or survey what's known about a topic. Single-pass; for multi-round adversarial research use ResearchCouncil in forge-council.
4SKILL.mdUpdated May 27, 2026
n4m3z/WriteDocs
tools
VerifiedTrustedCommunity
Author project documentation that future humans (and AI sessions) actually read. Covers TLDRs for tools, READMEs, runbooks, journals. USE WHEN write documentation, create tldr, tool one-pager, document a cli, write readme, runbook, journal entry, capture knowledge about a tool, distill a session into reusable notes.
4SKILL.mdUpdated May 25, 2026
n4m3z/StagedReview
development
VerifiedTrustedCommunity
Review your own staged changes via a code-review TUI before triggering a commit. USE WHEN about to commit, walking through your own staged diff, self-reviewing before approval, tuicr, revdiff, git diff cached.
4SKILL.mdUpdated May 25, 2026