diff --git a/qdrant-landing/content/articles/skill-md-meets-repl.md b/qdrant-landing/content/blog/skill-md-meets-repl.md similarity index 98% rename from qdrant-landing/content/articles/skill-md-meets-repl.md rename to qdrant-landing/content/blog/skill-md-meets-repl.md index 90f33c7f8..7ca22540a 100644 --- a/qdrant-landing/content/articles/skill-md-meets-repl.md +++ b/qdrant-landing/content/blog/skill-md-meets-repl.md @@ -1,14 +1,17 @@ --- title: "Two Approaches to Helping AI Agents Use Your API (And Why You Need Both)" -short_description: "Mintlify's skill.md and Armin Ronacher's REPL-first MCP solve different failure modes. Together, they define how agents should interact with developer tools." -description: "Two emerging patterns for agent-assisted development: static knowledge files and dynamic tool access. How they complement each other using Qdrant as a case study." -preview_dir: /articles_data/skill-md-meets-repl/preview -social_preview_image: /articles_data/skill-md-meets-repl/preview/social_preview.jpg -author: Thierry Damiba draft: false +slug: skill-md-meet-repl +description: "Two emerging patterns for agent-assisted development: static knowledge files and dynamic tool access. How they complement each other using Qdrant as a case study." +short_description: "Mintlify's skill.md and Armin Ronacher's REPL-first MCP solve different failure modes. Together, they define how agents should interact with developer tools." +preview_image: /blog/skill-md-meets-repl/repl-skill.png +social_preview_image: /blog/skill-md-meets-repl/repl-skill.png date: 2026-01-28T00:00:00-08:00 -weight: -200 -category: rag-and-genai +author: Thierry Damiba +featured: true +tags: + - agents + - blog --- AI coding agents fail in predictable ways when working with APIs. Two recent approaches from Mintlify and Armin Ronacher attack different failure modes. Understanding both reveals something useful about how agents should interact with developer tools. diff --git a/qdrant-landing/static/articles_data/skill-md-meets-repl/preview.png b/qdrant-landing/static/articles_data/skill-md-meets-repl/preview.png deleted file mode 100644 index d751224f4..000000000 Binary files a/qdrant-landing/static/articles_data/skill-md-meets-repl/preview.png and /dev/null differ diff --git a/qdrant-landing/static/articles_data/skill-md-meets-repl/preview/preview.jpg b/qdrant-landing/static/articles_data/skill-md-meets-repl/preview/preview.jpg deleted file mode 100644 index 0b899faf1..000000000 Binary files a/qdrant-landing/static/articles_data/skill-md-meets-repl/preview/preview.jpg and /dev/null differ diff --git a/qdrant-landing/static/articles_data/skill-md-meets-repl/preview/preview.webp b/qdrant-landing/static/articles_data/skill-md-meets-repl/preview/preview.webp deleted file mode 100644 index 183302662..000000000 Binary files a/qdrant-landing/static/articles_data/skill-md-meets-repl/preview/preview.webp and /dev/null differ diff --git a/qdrant-landing/static/articles_data/skill-md-meets-repl/preview/social_preview.jpg b/qdrant-landing/static/articles_data/skill-md-meets-repl/preview/social_preview.jpg deleted file mode 100644 index ff5e16ae2..000000000 Binary files a/qdrant-landing/static/articles_data/skill-md-meets-repl/preview/social_preview.jpg and /dev/null differ diff --git a/qdrant-landing/static/articles_data/skill-md-meets-repl/preview/title.jpg b/qdrant-landing/static/articles_data/skill-md-meets-repl/preview/title.jpg deleted file mode 100644 index ea518d20f..000000000 Binary files a/qdrant-landing/static/articles_data/skill-md-meets-repl/preview/title.jpg and /dev/null differ diff --git a/qdrant-landing/static/articles_data/skill-md-meets-repl/preview/title.webp b/qdrant-landing/static/articles_data/skill-md-meets-repl/preview/title.webp deleted file mode 100644 index 596553d7f..000000000 Binary files a/qdrant-landing/static/articles_data/skill-md-meets-repl/preview/title.webp and /dev/null differ diff --git a/qdrant-landing/static/blog/skill-md-meets-repl/repl-skill.png b/qdrant-landing/static/blog/skill-md-meets-repl/repl-skill.png new file mode 100644 index 000000000..d712156b2 Binary files /dev/null and b/qdrant-landing/static/blog/skill-md-meets-repl/repl-skill.png differ