<!-- mobian-agent-page publisher="dailydev" canonical="https://daily.dev/posts/skills-for-real-engineers-how-to-keep-claude-code-and-ai-tools-from-ruining-your-architecture-22u3jffno" -->

---
title: Skills For Real Engineers: How to Keep Claude Code and...
description: Matt Pocock open-sourced skills.sh, a set of disciplined primitives and workflows for Claude Code, Codex, and similar coding agents, aimed at preventing...
canonical: https://daily.dev/posts/skills-for-real-engineers-how-to-keep-claude-code-and-ai-tools-from-ruining-your-architecture-22u3jffno
twitter:card: summary_large_image
twitter:site: @dailydotdev
og:type: website
og:site_name: daily.dev
og:title: Skills For Real Engineers: How to Keep Claude Code and AI Tools From Ruining Your Architecture | daily.dev
og:description: Matt Pocock open-sourced skills.sh, a set of disciplined primitives and workflows for Claude Code, Codex, and similar coding agents, aimed at preventing...
og:url: https://daily.dev/posts/skills-for-real-engineers-how-to-keep-claude-code-and-ai-tools-from-ruining-your-architecture-22u3jffno
og:image: https://api.daily.dev/og/posts/22u3jffNo.png
og:image:alt: Skills For Real Engineers: How to Keep Claude Code and AI Tools From Ruining Your Architecture
og:image:width: 1200
og:image:height: 630
og:locale: en
---

> ## Documentation Index
> Fetch the complete documentation index at: https://daily.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Skills For Real Engineers: How to Keep Claude Code and AI Tools From Ruining Your Architecture

**[Showcase](https://daily.dev/sources/showcase)** · [@cristianolivera1](https://daily.dev/cristianolivera1) · 2 min read · 79 upvotes · 18 comments

## Summary

Matt Pocock open-sourced skills.sh, a set of disciplined primitives and workflows for Claude Code, Codex, and similar coding agents, aimed at preventing architectural mess from unstructured AI-generated code. The toolkit includes commands like /grill-me to force requirement clarification before coding, a CONTEXT.md file for ubiquitous domain language, /tdd and /diagnosing-bugs for structured red-green-refactor loops, and /improve-codebase-architecture for scanning code entropy and exporting HTML refactoring reports. It installs in under 30 seconds as a Claude Code plugin or editable local files.

## Content

Tired of AI agents guessing your requirements and dropping unstructured code blocks into your repository? "Vibe coding" is fun until you have to spend hours untangling the architectural mess. While existing frameworks try to automate development by completely owning the process, they often strip away your control, making unexpected bugs and regressions incredibly difficult to resolve.

Matt Pocock just open-sourced [skills.sh](http://skills.sh), a collection of highly disciplined primitives and workflows designed to fix the most painful failure modes of tools like Claude Code, Codex, and other modern coding agents. Instead of letting the AI hijack the pipeline, these small, composable scripts give you total control over the development cycle and establish a high-trust workflow based on decades of real engineering experience.

Key software engineering principles built into the toolkit:

- /grill-me and /grill-with-docs: Forces the AI to relentlessly interview you about your plan before writing a single line of code, closing the communication gap and ensuring perfect alignment.

- Ubiquitous Language via [CONTEXT.md](http://CONTEXT.md): Prevents the agent from being too verbose and burning tokens by feeding it your project's precise domain jargon, forcing it to use single words instead of long paragraphs.

- /tdd and /diagnosing-bugs: Encourages strict red-green-refactor loops and a disciplined debugging framework so the generated code actually runs and stays stable over time.

- /improve-codebase-architecture: Scans your entire codebase for software entropy, fighting the acceleration of code complexity that AI usually introduces by exporting interactive HTML reports highlighting refactoring opportunities.

It takes less than 30 seconds to set up, either as a managed Claude Code plugin or as editable local files that you fully own, modify, and hack around with. It is time to move past the hype and treat AI-driven development with actual engineering fundamentals.

**Github Repository: **[https://github.com/mattpocock/skills](https://github.com/mattpocock/skills)

## Community discussion

Top comments from developers on daily.dev.

**@gabibeyo** · 9 upvotes

> Skills like /grill-me and forced TDD are how you stop vibe-coding from eating the architecture. Worth shipping.
>
>
> One gap I keep seeing in enterprises: the workflow is disciplined on the way in, blind on the way through.
>
>
> You clarified requirements. You got a green test. You still can’t answer what the agent touched — which repos, which secrets, which “quick” cloud CLI — unless the developer self-reports.
>
>
> Harness for quality ≠ harness for behavior. Both matter. If you only industrialize prompts, you’ll get cleaner PRs from an actor you still don’t observe.

**@geekluffy** · 6 upvotes

> The `/grill-me` command is pure genius. Forcing the AI to interrogate your architecture plan _before_ touching a single line of code solves 90% of agent hallucinations. Vibe coding is fun but disciplined engineering is sustainable.

**@stevenb** · 6 upvotes

> I have tried the grill me with docs and found it useful but I have still to use wayfinder and teach which I think look interesting

**@phatdangminh** · 5 upvotes

> Thanks so much for this post.

**@dobegor** · 2 upvotes

> @cristianolivera1 skills dot sh link has nothing to do with Matt, it's run by Vercel

## Similar posts on daily.dev

- [How Claude Skills Replaced Our Documentation](https://daily.dev/posts/how-claude-skills-replaced-our-documentation-lfxb2loug) · DEV · 7 upvotes · 0 comments

---

Tags: [#architecture](https://daily.dev/tags/architecture), [#ai-coding](https://daily.dev/tags/ai-coding), [#claude-code](https://daily.dev/tags/claude-code), [#vibe-coding](https://daily.dev/tags/vibe-coding), [#tdd](https://daily.dev/tags/tdd)

[View this post on daily.dev](https://daily.dev/posts/skills-for-real-engineers-how-to-keep-claude-code-and-ai-tools-from-ruining-your-architecture-22u3jffno)

```json
{"@context":"https://schema.org","@graph":[{"@type":"Organization","@id":"https://daily.dev/#organization","name":"daily.dev","url":"https://daily.dev","logo":{"@type":"ImageObject","url":"https://daily.dev/apple-touch-icon.png","width":180,"height":180},"sameAs":["https://twitter.com/dailydotdev","https://github.com/dailydotdev","https://www.linkedin.com/company/daily-dev-ltd"]},{"@type":"WebSite","@id":"https://daily.dev/#website","url":"https://daily.dev","name":"daily.dev","publisher":{"@id":"https://daily.dev/#organization"},"potentialAction":{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https://daily.dev/search?q={search_term_string}"},"query-input":"required name=search_term_string"}}]}
{"@context":"https://schema.org","@type":"DiscussionForumPosting","mainEntityOfPage":"https://daily.dev/posts/skills-for-real-engineers-how-to-keep-claude-code-and-ai-tools-from-ruining-your-architecture-22u3jffno","headline":"Skills For Real Engineers: How to Keep Claude Code and AI Tools From Ruining Your Architecture","text":"Matt Pocock open-sourced skills.sh, a set of disciplined primitives and workflows for Claude Code, Codex, and similar coding agents, aimed at preventing architectural mess from unstructured AI-generated code. The toolkit includes commands like /grill-me to force requirement clarification before coding, a CONTEXT.md file for ubiquitous domain language, /tdd and /diagnosing-bugs for structured red-green-refactor loops, and /improve-codebase-architecture for scanning code entropy and exporting HTML refactoring reports. It installs in under 30 seconds as a Claude Code plugin or editable local files.","url":"https://daily.dev/posts/skills-for-real-engineers-how-to-keep-claude-code-and-ai-tools-from-ruining-your-architecture-22u3jffno","datePublished":"2026-08-24T02:17:54.859Z","dateModified":"2026-09-13T20:48:46.860Z","author":{"@type":"Person","name":"Cristian Olivera Chávez","url":"https://daily.dev/cristianolivera1","image":"https://lh3.googleusercontent.com/a/ACg8ocICzd1bW91kCFqI0PuT1IRi9n8e6m7C2_QMCxE2xLrx7d2Q5tY=s96-c","description":"Angular | NextJs | Tailwind | Laravel | Spring Boot","interactionStatistic":{"@type":"InteractionCounter","interactionType":{"@type":"EndorseAction"},"userInteractionCount":4750}},"image":"https://media.daily.dev/image/upload/s--9Rj2MwrY--/f_auto/v1787537875/posts/22u3jffNo?_a=BAMAMicg0","interactionStatistic":[{"@type":"InteractionCounter","interactionType":{"@type":"LikeAction"},"userInteractionCount":79},{"@type":"InteractionCounter","interactionType":{"@type":"CommentAction"},"userInteractionCount":18}],"comment":[{"@type":"Comment","text":"Skills like /grill-me and forced TDD are how you stop vibe-coding from eating the architecture. Worth shipping.\nOne gap I keep seeing in enterprises: the workflow is disciplined on the way in, blind on the way through.\nYou clarified requirements. You got a green test. You still can’t answer what the agent touched — which repos, which secrets, which “quick” cloud CLI — unless the developer self-reports.\nHarness for quality ≠ harness for behavior. Both matter. If you only industrialize prompts, you’ll get cleaner PRs from an actor you still don’t observe.","datePublished":"2026-08-24T06:24:35.722Z","url":"https://daily.dev/posts/22u3jffNo#c-imCKMejwg","author":{"@type":"Person","name":"Gabi Beyo","url":"https://daily.dev/gabibeyo","image":"https://lh3.googleusercontent.com/a/ACg8ocLemxROLDZ6RYrC2zzv0zJ9ezzj62VOCNwxNCdVNa_M9tqvU4JI=s96-c"},"interactionStatistic":{"@type":"InteractionCounter","interactionType":{"@type":"LikeAction"},"userInteractionCount":9}},{"@type":"Comment","text":"The /grill-me command is pure genius. Forcing the AI to interrogate your architecture plan before touching a single line of code solves 90% of agent hallucinations. Vibe coding is fun but disciplined engineering is sustainable.","datePublished":"2026-08-25T16:05:51.080Z","url":"https://daily.dev/posts/22u3jffNo#c-hoi9hASph","author":{"@type":"Person","name":"GeekLuffy","url":"https://daily.dev/geekluffy","image":"https://avatars.githubusercontent.com/u/71143694?v=4"},"interactionStatistic":{"@type":"InteractionCounter","interactionType":{"@type":"LikeAction"},"userInteractionCount":6}},{"@type":"Comment","text":"I have tried the grill me with docs and found it useful but I have still to use wayfinder and teach which I think look interesting","datePublished":"2026-08-24T07:39:19.114Z","url":"https://daily.dev/posts/22u3jffNo#c-Wi5C8OM3z","author":{"@type":"Person","name":"Steven Burrows","url":"https://daily.dev/stevenb","image":"https://media.daily.dev/image/upload/s--J8fVAfGw--/f_auto/v1705434114/avatars/avatar_Ghvs0HorIR1tgho0zgcsY"},"interactionStatistic":{"@type":"InteractionCounter","interactionType":{"@type":"LikeAction"},"userInteractionCount":6}},{"@type":"Comment","text":"Thanks so much for this post.","datePublished":"2026-08-24T09:01:42.533Z","url":"https://daily.dev/posts/22u3jffNo#c-Gqm18xYgU","author":{"@type":"Person","name":"Phat Dang Minh","url":"https://daily.dev/phatdangminh","image":"https://media.daily.dev/image/upload/s--uEe-dzLM--/f_auto/v1747452091/avatars/avatar_U9YNpHvqD7jM3IxMsDTsP?_a=BAMClqUq0"},"interactionStatistic":{"@type":"InteractionCounter","interactionType":{"@type":"LikeAction"},"userInteractionCount":5}},{"@type":"Comment","text":"@cristianolivera1 skills dot sh link has nothing to do with Matt, it’s run by Vercel","datePublished":"2026-08-24T09:25:25.436Z","url":"https://daily.dev/posts/22u3jffNo#c-DSdWSbByX","author":{"@type":"Person","name":"George Dobrovolsky","url":"https://daily.dev/dobegor","image":"https://lh3.googleusercontent.com/a/ACg8ocIVV0nxdkDJ2seOyPz-PViTT-bH9O4B6d_WKWOAVeJzV_Pk-Q=s96-c"},"interactionStatistic":{"@type":"InteractionCounter","interactionType":{"@type":"LikeAction"},"userInteractionCount":2}}],"isPartOf":{"@type":"WebPage","url":"https://daily.dev/squads/showcase","name":"Showcase"}}
{"@context":"https://schema.org","@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https://daily.dev"},{"@type":"ListItem","position":2,"name":"Showcase","item":"https://daily.dev/squads/showcase"},{"@type":"ListItem","position":3,"name":"Skills For Real Engineers: How to Keep Claude Code and AI Tools From Ruining Your Architecture"}]}
```

