diff --git a/CHALLENGE.md b/CHALLENGE.md
new file mode 100644
index 00000000..48c5f61c
--- /dev/null
+++ b/CHALLENGE.md
@@ -0,0 +1,62 @@
+# 🏆 Memanto + Matt Pocock Developer Skills Challenge
+
+**Prize: $100**
+
+We're excited to announce a developer skills challenge in partnership with [Matt Pocock](https://www.mattpocock.com/) — the creator of [Total TypeScript](https://www.totaltypescript.com/) and a leading voice in the TypeScript community.
+
+## 📜 The Challenge
+
+Build a **real-world project** that demonstrates Memanto's memory capabilities in a meaningful way. The project should:
+
+- Use at least two of Memanto's core primitives: `remember`, `recall`, or `answer`.
+- Showcase **persistence across sessions** (prove that memories survive restarts).
+- Be well-documented with a clear README, installation instructions, and a demo video or GIF.
+- Be open source (public repo on GitHub).
+
+**Bonus points** for:
+- Integrating with TypeScript ecosystem tools (like Matt Pocock's work).
+- Using Memanto's typed memory categories and confidence/provenance metadata.
+- Creating a multi-agent scenario (e.g., two AI agents sharing memory).
+- Implementing temporal queries (`as-of`, `changed-since`).
+
+## 💰 Prize & Judging
+
+- **Grand Prize: $100** awarded to the best submission.
+- **Two Honorable Mentions**: $25 each (if quality warrants).
+- Judged by the Memanto team and Matt Pocock.
+
+### Judging Criteria
+
+| Criterion | Weight |
+|-----------|--------|
+| Technical complexity & creativity | 40% |
+| Quality of documentation & demo | 25% |
+| Adherence to Memanto best practices | 20% |
+| TypeScript / ecosystem integration | 15% |
+
+## 📅 Timeline
+
+| Milestone | Date |
+|-----------|------|
+| Challenge opens | **Immediately** |
+| Submission deadline | **30 days from now** (see exact date on Discord) |
+| Winners announced | 7 days after deadline |
+
+## 🚀 How to Participate
+
+1. **Sign up** for a [Moorcheh API key](https://console.moorcheh.ai/api-keys) (free tier includes 100K ops/month).
+2. **Clone** this repository and review the [README](README.md) and existing [integrations](integrations/) for inspiration.
+3. **Build** your project in any language (Python, TypeScript, etc.) that uses Memanto (via REST API, MCP, or CLI).
+4. **Submit** by creating a GitHub Issue on this repository with the title `[Challenge Submission] My Project Name` including:
+ - Link to your public repo.
+ - A short description (2–3 paragraphs).
+ - A link to a demo video/GIF (optional but recommended).
+5. **Share** your submission on the [Memanto Discord](https://discord.gg/CyxRFQSQ3p) in the `#challenge` channel for visibility.
+
+## ❓ Questions?
+
+Join the [Discord server](https://discord.gg/CyxRFQSQ3p) and ask in the `#challenge` channel. You can also tag @MoorchehAI on Twitter/X.
+
+---
+
+*The Memanto team reserves the right to extend, modify, or cancel the challenge at any time. Prizes paid via PayPal or equivalent. All submissions must be original work and comply with the MIT license of this repository.*
\ No newline at end of file
diff --git a/README.md b/README.md
index 9da5985e..9181ddd9 100644
--- a/README.md
+++ b/README.md
@@ -18,6 +18,9 @@
+
+ 
+
@@ -39,6 +42,14 @@
---
+## 🏆 Developer Skills Challenge with Matt Pocock
+
+We partnered with [Matt Pocock](https://www.mattpocock.com/) — TypeScript educator and creator of Total TypeScript — to create a **developer skills challenge** that tests your ability to build with Memanto.
+
+👉 **See [CHALLENGE.md](CHALLENGE.md) for full details, prizes, and submission instructions.**
+
+---
+
## What Is MEMANTO?
**MEMANTO is a memory agent. It remembers, recalls, and answers — so your agents can achieve long-term goals and avoid confusion.**
@@ -198,7 +209,7 @@ By default, call the endpoints on your local server (for example: `"http://127.0
### Real Impact
| Feature | Traditional | Moorcheh |
-|---------|------------|----------|
+|---------|------------|---------|
| Write-to-Search | Minutes | **Instant** |
| Accuracy | Approximate | **Exact** |
| Idle Costs | Always running | **Zero** |
@@ -241,4 +252,4 @@ Have questions or feedback? We're here to help:
---
-**MIT License**
+**MIT License**
\ No newline at end of file