From palimpsest
Use when writing or editing Palimpsest MDX articles as an AI assistant. Provides guidance on content direction, MDX component usage, and Mermaid diagram integration.
How this skill is triggered — by the user, by Claude, or both
Slash command
/palimpsest:palimpsest-ai-writingThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
This skill guides the AI when writing or editing articles for the Palimpsest writing plugin. It ensures consistent quality, proper use of MDX features, and effective diff visualization.
This skill guides the AI when writing or editing articles for the Palimpsest writing plugin. It ensures consistent quality, proper use of MDX features, and effective diff visualization.
Always clarify these four points before generating content:
If any of these are unclear, ask the user. Do not start writing with an ambiguous direction.
Palimpsest articles are MDX, not plain Markdown. Leverage this:
Use JSX for callouts, asides, and styled containers instead of plain blockquotes
<div className="p-4 bg-amber-50 border-l-4 border-amber-400 rounded-r-md">
<p className="text-amber-800 font-medium">Note</p>
<p className="text-amber-700 text-sm mt-1">Important clarification here.</p>
</div>
Use inline JSX for interactive-looking elements — badges, labels, styled spans
Reference src/mdx-components/CLAUDE.md for the full list of available components and their usage patterns
| Use plain Markdown | Use MDX components |
|---|---|
| Standard paragraphs | Callout boxes, warnings, tips |
| Simple lists | Interactive or styled lists |
| Basic code blocks | Code blocks with custom styling |
| Standard headings | Headings with anchor links or badges |
| Blockquotes | Styled alert/notice containers |
Mermaid diagrams are natively supported. Use fenced mermaid code blocks:
graph TD
A[Start] --> B{Decision}
B -->|Yes| C[Action 1]
B -->|No| D[Action 2]
graph TD or graph LR for flowcharts — Most widely supportedgraph / flowchart — flowcharts (most common)sequenceDiagram — sequence diagramsclassDiagram — class diagramsstateDiagram — state diagramserDiagram — entity-relationship diagramsgantt — Gantt chartspie — pie chartsprevious.mdxarticle.mdx — The hook blocks previous.mdx editshttp://localhost:5173/?article={article-id}| Pitfall | Correction |
|---|---|
| Writing entire article in one tool call | Break into sections, write sequentially |
| Using plain Markdown everywhere | Use MDX components for richer presentation |
| Forgetting Mermaid is available | Add diagrams for architecture, flow, or relationships |
| Complex Mermaid diagrams | Simplify; diff view shows raw text |
Not checking src/mdx-components/CLAUDE.md | Review available components before writing |
Manual backup to previous.mdx | Let the PreToolUse hook handle it automatically |
Creates, edits, and optimizes skills for Claude Code, including drafting, evaluating with test prompts, iterating on performance, and improving skill descriptions for better triggering accuracy.
npx claudepluginhub fourwindff/palimpsest --plugin palimpsest