{"slug": "five-building-blocks-for-agentic-works-skills-prompts-instructions-mcp-and-sub", "title": "Five Building Blocks for Agentic Works: Skills, Prompts, Instructions, MCP and Sub-Agents", "summary": "GitHub's Copilot documentation outlines five building blocks for reliable agentic systems: project instructions, prompts, MCP, skills, and sub-agents, each addressing distinct problems in safety, usability, accuracy, discipline, and scalability. The stack is illustrated with an incident investigation assistant that uses telemetry MCP servers and structured workflows to enforce mandatory checkpoints and prevent hallucinations.", "body_md": "TL;DR — Key Takeaways\n\n- Reliable agentic systems require five distinct layers working as a stack.\n- Project instructions enforce permanent safety rules and non-negotiable constraints.\n- Prompts give users a simple, predictable way to start a task.\n- MCP connects the agent to live systems and real operational data.\n- Skills enforce repeatable workflows, checkpoints and documentation requirements.\n- Sub-agents perform complex or parallel work without cluttering the main conversation.\n- Removing any layer creates gaps in safety, usability, accuracy, discipline or scalability.\n\nYou have built an agentic system. It works at times. Sometimes it forgets steps. Sometimes it hallucinates conclusions. Sometimes it gets lost in 47 subprocess threads, and your user is drowning in noise.\n\nYou knew something was off, but you couldn’t name it.\n\nIt is because you were trying to solve five different problems with one tool.\n\n### The Five Building Blocks: a Stack, Not Options\n\nEach layer solves a different problem. Each solution depends on the layers below.\n\n### Project: the Incident Investigation Assistant\n\nPicture this: It’s 2 a.m. Production is down. Your DRI opens a chat window and types an app name. What should happen next?\n\nNot chaos, not 47 tabs opening, not jumping to conclusions based on stale data.\n\nInstead, a calm, structured walkthrough. One step at a time. Real data. Mandatory checkpoints. Parallel exploration that stays invisible. A root cause that actually holds up.\n\nThis is what great incident investigation systems do, and to build one, you need all five building blocks.\n\nLet’s walk through it.\n\n### Layer 1: Project Instructions — the Rules That Never Bend\n\nBefore you write anything else, establish what is sacred.\n\nFor an incident system:\n\n.github/copilot-instructions.md- NEVER conclude root cause without the full checklist- NEVER push directly to main- NEVER skip a diagnostic step, ever- NEVER create a ticket without human sign-off\n\nThese are not suggestions. They are non-negotiable rules that apply to every single interaction.\n\nThat is why they live in instructions, not in a skill. They are the foundation.\n\nyour-project/ .github/ copilot-instructions.md # The rules. Always active. README.md …\n\nNo exceptions. No working around them. The system enforces them from day one.\n\n### Layer 2: Prompts — the Clean Front Door\n\nYour DRI should never have to think about what to ask. Prompts are the answer.\n\nA prompt is one focused thing. One clean request. One predictable result.\n\n/investigate-incident <app name>\n\nThe user provides the app name. You promise back: Structured findings, live data, root cause hypothesis.\n\nDone. Clear. No ambiguity.\n\n—mode: agentdescription: Investigate a production incident, step by stepagent: Investigation Commander—# Investigate an incident## You provide- Incident ID, app name or time range## You get back- Live telemetry snapshot- Structured investigation walkthrough- Root cause hypothesis with evidence- Recommended actions\n\nPrompts stay lean. They do not contain the workflow. That is the skill’s job. Prompts just say “Here is the door. Walk through it.”\n\n### Layer 3: MCP — Your Connection to the Real World\n\nYour agent can reason all day. However, without real data, it is just guessing.\n\nMCP fixes that. It connects to the systems that know the truth.\n\nSet up MCP servers:\n\n# mcp-servers/telemetry.yamlid: telemetryname: Telemetry Databasetype: stdiocommand: uvx telemetry-query-mcp# mcp-servers/incidents.yamlid: incidentsname: Incident Management Systemtype: httpurl: https://incidents-api.example.com/v1authType: oauth\n\nNow your agent has superpowers:\n\n- run_query(sql) — Ask the telemetry system directly.\n- get_incident(id) — Fetch live incident data.\n- list_incidents(filters) — Search incidents in real-time.\n\n*MCP does one thing: **I** t gives you access. *It doesn’t tell you what to do with that access. That is the skill’s job.\n\n### Layer 4: Skills — the Good Stuff\n\nSkills are where you encode everything you have learned the hard way.\n\nAn investigation skill is not just instructions. It is a structured process that cannot be skipped.\n\nskills/investigate-incident/ SKILL.md # The workflow engine references/ investigation-checklist.md # What must be done root-cause-template.md # How findings are documented\n\nHere is the enforcement:\n\nYou will follow six mandatory steps — not five, not seven but six.\n\n- Gather app metadata from the telemetry system (show me the results).\n- Query error logs (show me what broke).\n- Check dependencies (show me what depends on this).\n- Review recent deploys (show me what changed).\n- Check system configuration (show me what is different).\n*O**nly*after steps 1–5, propose the root cause.\n\nSave every finding to investigation-findings.md as you go. No step gets skipped. No shortcuts. No exceptions.\n\nA prompt can describe steps. A skill enforces them. That is the difference.\n\n### Layer 5: Sub-Agents — Keep the Main Thread Clean\n\nHere is where it gets fun: Parallel work that doesn’t create noise.\n\nWhen your DRI asks “What services depend on this app?”, you do not dump 47 queries on them.\n\nInstead:\n\nMain Agent: “Explore all downstream dependencies. Return only the critical ones with a brief summary.”Sub-Agent (isolated, read-only): Runs deep queries, filters results, synthesizes findingsReturns: “Critical dependencies: Service A, Service B, Service C” (Full details in attached file)\n\nThe DRI sees one clean summary. The invisible work happened seamlessly and the thread stayed readable.\n\nSub-agents shine when you need: Heavy codebase exploration without cluttering the main thread; parallel independent investigations; access to different tools at different stages (read-only for analysis, write-capable for implementation).\n\n### Putting it All Together: Project Structure\n\nHere is what it looks like when you assemble all five:\n\nincident-investigation-assistant/ .github/ copilot-instructions.md Layer 1: Always-on rules prompts/ investigate-incident.prompt.md Layer 2: User entry point mcp-servers/ telemetry.yaml Layer 3: Live data incidents.yaml Layer 3: Live data skills/ investigate-incident/ SKILL.md Layer 4: Workflow engine references/ investigation-checklist.md root-cause-template.md explore-dependencies/ Layer 5: Sub-agent skill SKILL.md agents/ main-investigation-agent.yaml dependency-explorer-agent.yaml Sub-agent definition README.md\n\nEvery piece in its place. Every piece doing one job.\n\n### The Workflow in Action: Step by Step\n\nYour DRI types: /investigate-incident my-app\n\nHere is what happens under the hood:\n\n```\nPrompt activates (Layer 2)\n“What incident are we looking at? Give me the app name.” \nInstructions kick in (Layer 1)\nThe agent knows the non-negotiables: No skipping steps; wait for approval\nSkill starts running (Layer 4)\nCalls telemetry MCP to fetch app metrics\nShows the DRI checkpoint 1 results\nWaits for “continue” before moving to step 2 \nSkill continues (Layer 4 + Layer 3)\nRepeats for steps 2–5\nEach step shows results, waits for approval \nAfter step 5, sub-agent kicks in (Layer 5)\nMain Agent spawns a read-only sub-agent\nSub-agent explores dependencies in isolation\nReturns: “Critical dependencies found: 3” \nSkill closes out (Layer 4)\nProposes root cause with evidence\nAgent asks for approval (Layer 1 enforcement)\n“Create ticket? Notify team?”\nWaits for the DRI to approve before acting\n```\n\nThe DRI never has to think “What do I do next?” The system guides them. The system prevents skipping. The system keeps the signal-to-noise ratio clean.\n\n### Why All Five Matter (and What Breaks Without Them)\n\n*No**i** nstructions?*People bypass safety rules. Chaos.*No**p** rompts?*Users never know what to ask. Frustration.*No MCP?*Conclusions are guesses. Unreliable.*No**s** kills?*Important steps get skipped. Incomplete results.*No**s** ub-**a** gents?*The main thread gets cluttered. Cognitive overload.\n\nEach one solves a real problem.\n\n*Instructions*keep you safe.*Prompts*keep you usable.*MCP*keeps you grounded in reality.*Skills*keep you disciplined.*Sub-**a** gents*keep you scalable.\n\n### Final Takeaway\n\nYou do not pick one. You do not try to make one do everything.\n\nYou use all five as a stack:\n\n- Start with instructions to lock in what matters.\n- Add prompts to give users a clean interface.\n- Connect MCP servers to ground everything in reality.\n- Build skills to encode your institutional knowledge.\n- Spawn sub-agents to manage complexity and scale.\n\nOnce you see them as complementary layers instead of competing options, you stop fighting the system.\n\nThat is when you build incident assistants that actually work, code reviewers your team trusts, deployment systems that never skip a step, alert managers that catch the right signal.\n\nThat is when agentic works stop being a frustration and start being a force multiplier.\n\nBuild it right. Use all five.", "url": "https://wpnews.pro/news/five-building-blocks-for-agentic-works-skills-prompts-instructions-mcp-and-sub", "canonical_source": "https://techstrong.ai/features/five-building-blocks-for-agentic-works-skills-prompts-instructions-mcp-and-sub-agents/", "published_at": "2026-08-06 08:55:11+00:00", "updated_at": "2026-08-09 13:09:06.825525+00:00", "lang": "en", "topics": ["ai-agents", "ai-tools", "ai-infrastructure", "developer-tools"], "entities": ["GitHub", "Copilot", "MCP"], "alternates": {"html": "https://wpnews.pro/news/five-building-blocks-for-agentic-works-skills-prompts-instructions-mcp-and-sub", "markdown": "https://wpnews.pro/news/five-building-blocks-for-agentic-works-skills-prompts-instructions-mcp-and-sub.md", "text": "https://wpnews.pro/news/five-building-blocks-for-agentic-works-skills-prompts-instructions-mcp-and-sub.txt", "jsonld": "https://wpnews.pro/news/five-building-blocks-for-agentic-works-skills-prompts-instructions-mcp-and-sub.jsonld"}}