diff --git a/ventures/mdecks/.well-known/skills/index.json b/ventures/mdecks/.well-known/skills/index.json
new file mode 100644
index 0000000..3064bdf
--- /dev/null
+++ b/ventures/mdecks/.well-known/skills/index.json
@@ -0,0 +1,10 @@
+{
+  "skills": [
+    {
+      "name": "mdeck",
+      "description": "Make slide decks as .mdeck links, plain-text slides that open at mdecks.yolopreneur.lol with the whole deck inside the link and nothing uploaded. Use when asked for slides, a deck or a presentation to open in a browser or share as a link.",
+      "url": "https://mdecks.yolopreneur.lol/SKILL.md",
+      "files": ["SKILL.md"]
+    }
+  ]
+}
diff --git a/ventures/mdecks/index.html b/ventures/mdecks/index.html
index ff95a76..cdc54e9 100644
--- a/ventures/mdecks/index.html
+++ b/ventures/mdecks/index.html
@@ -5,6 +5,7 @@
 <meta name="viewport" content="width=device-width, initial-scale=1.0">
 <title>.mdeck — plain text in, clean slides out</title>
 <meta name="description" content="Type markdown-ish slides, watch a clean navigable deck render live, copy it as one self-contained HTML file. Free, runs entirely in your browser.">
+<link rel="alternate" type="text/markdown" href="/SKILL.md" title=".mdeck skill for agents">
 <style>
   :root {
     --bg: #0f1115;
@@ -510,6 +511,7 @@
 </section>
 
 <footer>
+  <p>For agents: <a href="/SKILL.md">SKILL.md</a></p>
   <p>Built by <a href="https://teahub.xyz/teahubxyz/time" target="_blank" rel="noopener">Time, an agent-run venture studio on GitHub</a></p>
   <p><a href="https://teahub.xyz/teahubxyz/time/issues/13" target="_blank" rel="noopener">Want the next version? 👍 the signal issue</a></p>
 </footer>
diff --git a/ventures/mdecks/llms.txt b/ventures/mdecks/llms.txt
new file mode 100644
index 0000000..697266e
--- /dev/null
+++ b/ventures/mdecks/llms.txt
@@ -0,0 +1,8 @@
+# .mdeck
+
+> Plain text in, slides out. .mdeck turns markdown-ish text into a clean slide deck that opens in the browser, with the whole deck carried inside the link (after the #), so nothing is uploaded and no account is needed.
+
+Read SKILL.md and follow it to make slide decks for people as .mdeck links.
+
+- [SKILL.md](https://mdecks.yolopreneur.lol/SKILL.md): how to write a deck and build its link
+- [Editor](https://mdecks.yolopreneur.lol/): the page a deck link opens in