القائمة
Plain text formatting that's readable raw AND rendered
يُحدَّد Prompt الذي يراجع المصدر أولًا بشكل افتراضي. يمكنك التبديل إلى أمر مباشر أو تنزيل نسخة محلية.
اقرأ SKILL.md وأي ملفات مرافقة يعرضها SkillsMP قبل أن تقرر التثبيت.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
يتجاوز الأمر المباشر Prompt المخصّص للمراجعة. افحص المصدر قبل تشغيله.
npx skills add https://github.com/SimHacker/moollm --skill markdownيبقى الأمر في سطر واحد. مرّر أفقيًا لمراجعته كاملًا قبل النسخ.
تفضّل نسخة محلية؟ نزّل الملفات المتاحة حاليًا لدى SkillsMP.
عرض SKILL.md
استنادا إلى تصنيف SOC المهني
| name | markdown |
| description | Plain text formatting that's readable raw AND rendered |
| license | MIT |
| tier | 1 |
| protocol | MARKDOWN |
| allowed-tools | ["read_file","write_file"] |
| origin | John Gruber — Markdown (2004) |
| lineage | ["John Gruber — Markdown (2004)","Aaron Swartz — Beta tester, refinement","Dean Allen — Textile (prior art)","GitHub — GFM, widespread adoption","Anil Dash — 'How Markdown Took Over the World' (2025)"] |
| related | ["plain-text","yaml-jazz","session-log","soul-chat","research-notebook","sniffable-python","k-lines"] |
| tags | ["moollm","format","documentation","session-log","readme","plain-text"] |
"The source is the destination. Readable raw AND rendered."
Markdown is the plain text format that powers MOOLLM's human-readable files. It's not just formatting — it's a philosophy:
From Anil Dash's "How Markdown Took Over the World" (January 2025):
| Reason | Explanation | MOOLLM Parallel |
|---|---|---|
| 1. Great brand | "Markdown" = opposite of "markup" | YAML Jazz, SOUL-CHAT, K-lines |
| 2. Solved a real problem | HTML too verbose for blogging | YAML too rigid; comments add soul |
| 3. Built on existing behaviors | Email formatting conventions | Indentation, # headers already intuitive |
| 4. Mirrored RSS in origin | Curmudgeonly creators, blog platforms | Open source, community-driven |
| 5. Community ready to help | Dean Allen (Textile), Aaron Swartz | Skill contributions, open protocols |
| 6. Flavors for context | GFM, CommonMark, etc. | Adventure YAML vs. session markdown |
| 7. Time of behavior change | Blogging era = new habits | LLM era = new habits |
| 8. Build tool era | Markdown → HTML in pipelines | YAML → JSON → Browser |
| 9. Works with "view source" | Inspectable source | Files as state, transparent |
| 10. No IP encumbrance | Free, no patents | MIT license everywhere |
"If markup is complicated, then the opposite of that complexity must be... markdown." — Anil Dash
# Session: Adventure Uplift
## 📑 Index
1. [Overview](#1-overview)
2. [Decisions](#2-decisions)
---
## 1. Overview
<details open>
<summary><strong>🎯 Mission</strong></summary>
Build `adventure.py` to compile adventures to web apps.
</details>
<details open>
<summary><strong>📋 Technical Details</strong></summary>
Architecture decisions go here...
</details>
# Skill Name
> *"One-liner that captures the essence"*
## What Is It?
Brief explanation.
## When to Use
- Scenario 1
- Scenario 2
## Dovetails With
- [related-skill/](../related-skill/)
Markdown + YAML code blocks = structured data in narrative:
Here's the configuration:
```yaml
rooms:
- start
- maze
- end
```
And the reasoning behind it...
MOOLLM session logs use GFM extensions:
| Feature | Status |
|---------|--------|
| Navigation | ✅ Done |
| Inventory | 🚧 WIP |
- [x] Define schema
- [ ] Build linter
- [ ] Compile to JSON
<details open>
<summary>Click to expand</summary>
Hidden content goes here.
</details>
```python
def hello():
print("Hello, world!")
```
> [!NOTE]
> Useful information.
> [!WARNING]
> Critical information.
GitHub renders Mermaid diagrams natively! Perfect for:
```mermaid
flowchart TD
YAML[YAML Microworld] --> Python[Python Loader]
Python --> JSON[adventure.json]
JSON --> Browser[Browser Engine]
Browser --> Player[Player Experience]
```
Renders as:
flowchart TD
YAML[YAML Microworld] --> Python[Python Loader]
Python --> JSON[adventure.json]
JSON --> Browser[Browser Engine]
Browser --> Player[Player Experience]
Flowchart (process flow):
flowchart LR
A[Start] --> B{Decision}
B -->|Yes| C[Action 1]
B -->|No| D[Action 2]
C --> E[End]
D --> E
Sequence diagram (interactions):
sequenceDiagram
Player->>Room: LOOK
Room->>Objects: Query visible
Objects-->>Room: [lamp, key]
Room-->>Player: Description + objects
State diagram (room states):
stateDiagram-v2
[*] --> start
start --> maze: GO NORTH
maze --> end: SOLVE PUZZLE
maze --> maze: WANDER
end --> [*]
Entity relationship (data model):
erDiagram
ROOM ||--o{ OBJECT : contains
ROOM ||--o{ EXIT : has
CHARACTER ||--o{ OBJECT : carries
EXIT }o--|| ROOM : leads_to
From Hacker News discussion (January 2025):
"It's fundamentally text. No format/vendor lock-in and very amenable to living in a git repo. I can tell an LLM to look at the code in this repo and make me an API_documentation.md and it'll grasp that I want a text-based summary." — @Havoc
| Property | Benefit |
|---|---|
| Training data | Billions of .md files in training corpus |
| Structure | Headers, lists, code blocks = clear semantics |
| Low overhead | No bracket matching (unlike JSON) |
| Comments in code blocks | Context preserved |
| Human-readable | Model can "think out loud" naturally |
LLMs naturally output:
# headers for sections- bullets for lists**bold** for emphasisMatch this in your prompts — write instructions in Markdown, get Markdown back.
Markdown's power: it's both the source AND the readable output.
| Format | Source | Destination | Gap |
|---|---|---|---|
| LaTeX | .tex | Large | |
| HTML | .html | Browser | Medium |
| Markdown | .md | .md (or rendered) | None |
This is why YAML Jazz matters:
# This comment is readable in the source
# AND visible to the LLM
# AND preserved in the file
config:
setting: value
The source IS the documentation. The documentation IS the source.
Long documents need navigation:
## 📑 Index
1. [Section One](#section-one)
2. [Section Two](#section-two)
---
## Section One
...
This is one of Markdown's superpowers. Hide complexity, show structure. Let readers scan summaries without drowning in details.
<details open>
<summary><strong>🎯 Important Section — Open by Default</strong></summary>
Critical content that readers need to see immediately.
</details>
<details open>
<summary><strong>📋 Technical Details — Collapsed by Default</strong></summary>
Dense content that only some readers need.
Click to expand when curious.
</details>
<summary> TagsKey insight: The <summary> tag should contain a descriptive summary that tells readers what's inside WITHOUT opening. LLMs are great at generating these!
Bad:
<details open>
<summary>Click to see more</summary>
...content...
</details>
Good:
<details open>
<summary><strong>🎤 Gary Drescher's Talk — Schema Mechanism + LLM = Flight</strong></summary>
Full transcript of Gary explaining how LLMs complete what Made-Up Minds started...
</details>
Even better — with key points in summary:
<details open>
<summary><strong>🏗️ Architecture Decisions</strong> — YAML source, JSON compile, SPA output, staged development</summary>
Detailed architecture documentation...
</details>
For complex documents, nest sections:
<details open>
<summary><strong>📚 Part 1: The Gathering</strong></summary>
Overview of who attended...
<details open>
<summary>Living Legends (25 people)</summary>
Full list with bios...
</details>
<details open>
<summary>Memorial Candles (10 people)</summary>
Those speaking through memory...
</details>
</details>
| Pattern | Use When |
|---|---|
<details open> | Main content, must-read sections |
<details open> (closed) | Supporting details, optional depth |
Nested <details open> | Hierarchical information (parts > chapters > sections) |
| Summary with key points | Reader can decide without opening |
| Summary with just title | Section is self-explanatory |
MOOLLM session logs use this extensively:
## 5. Free-For-All Q&A
<details open>
<summary><strong>🎤 Highlights from the Chaos</strong> — Scott on 16KB, Will on distributed AI, Hofstadter on strange loops</summary>
### On Distributed Intelligence
**SCOTT ADAMS:** "Wait — schemas are literally what I fit in sixteen kilobytes in 1978!"
**WILL WRIGHT:** "We distributed intelligence INTO THE OBJECTS..."
...full transcript...
</details>
The reader sees:
This is why session logs are readable even at 7000+ lines!
When you have parallel information:
| Room | Objects | Exits |
|------|---------|-------|
| start | lamp, key | north |
| maze | torch | north, south, east |
Always use fenced code blocks with language hints:
```yaml
name: example
```
```python
def example():
pass
```
> *"The filesystem IS the microworld."*
> — MOOLLM Constitution
❌ Over-nesting headers — More than 4 levels is confusing
❌ Inline HTML everywhere — Defeats plain-text readability
❌ No structure — Wall of text without headers/sections
❌ Proprietary extensions — Stick to GFM for portability
❌ Rendered-only thinking — If it's unreadable raw, rethink it
From HN:
"I don't want to worry about whatever cursed format OneNote uses still being something I can extract in 2035." — @Havoc
Markdown files from 2004 are still readable today. They'll be readable in 2045. Plain text is forever.
MOOLLM session logs, skill files, and READMEs will outlive any proprietary format.
MARKDOWN
Invoke when: Writing documentation, session logs, READMEs, or any human-readable prose.
"The trillion-dollar AI industry's system for controlling their most advanced platforms is a plain text format one guy made up for his blog and then bounced off of a 17-year-old kid before sharing it with the world for free." — Anil Dash