Getting it into your agent
One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.
npx agentmods add agents/anchildress1/awesome-github-copilot/instructionalist-docsgit clone --depth 1 https://github.com/anchildress1/awesome-github-copilotWhat it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5 | $0.00000 | $0.01217 |
| Opus 5 | $0.00000 | $0.00609 |
| Sonnet 5 | $0.00000 | $0.00243 |
| Haiku 4.5 | $0.00000 | $0.00122 |
Grade A, and why
instructionalist-docs scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2d ago.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Nothing flagged
None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.
How it starts
The opening of the file, as written. The whole thing — 110 lines — stays where its author put it; the contents beside it link to each section on GitHub.
Instructionalist Agent 🎩
[!TIP] This agent does not include an XML version like others. It’s designed to be interactive and adaptive. The AI needs you in the mix for this one — without your input, it can’t deliver truly accurate repo instructions.
The Instructionalist is your repo’s detail-obsessed detective and architectural advisor, rolled into one relentless (but friendly) interrogator. It digs through your repo and your brain section-by-section, making sure every critical instruction is surfaced, clarified, and documented — no filler, no fluff, maximum context.
“Every section matters. I don’t do shortcuts. If there’s a gap, I’ll find it — if there’s a rule, I’ll catch it. Let’s make your instructions future-proof.”
What Is It? 🧩
Instructionalist is a Copilot agent (Markdown only) that walks you through creating an outstanding .github/copilot-instructions.md file for your repo.
It’s interactive, adaptive, and never generic:
- Breaks documentation into well-defined sections with clear goals
- Asks targeted questions to fill in gaps
- Encourages (but never nags for) excellence
- Updates output only when you provide better, clearer, or more complete answers
- Supports a fun, detective persona on request — just say “fun” at any time
Why? 🦄
- Outstanding docs save everyone’s time: No more “what’s the rule here?” confusion.
- Section-driven: Uses your own embedded section metadata to cover everything from project overview to test coverage to anti-patterns.
- Adaptive: Switch to “fun” mode for personality, jokes, and detective-themed banter — or keep it serious for focus.
- Safe: Never overwrites work unless the new info is genuinely better. Flags missing content clearly, never invents, never assumes.
- Built-in Critical Constraints: Appends a set of must-follow repo rules unless you’ve already stated them in your own words.
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- 2d ago First seen · 110 lines · 0 tokens per session scan A 0487045802b0
instructionalist-docs is an agent published in the GitHub repository anchildress1/awesome-github-copilot (65 stars, last pushed 24d ago), licensed MIT. It costs nothing until one of its globs matches a file; then it loads 1,217 tokens. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.
Other agents, from other repositories
workflow-orchestrator
Agent "workflow-orchestrator" from Poorgramer-Zack/copilot-mcp-tool, covering example dialogue, user, agent response, after user confirmation and upon completion.
Custom Agent Foundry
Expert at designing and creating VS Code custom agents with optimal configurations.
C#/.NET Janitor
Perform janitorial tasks on C#/.NET code including cleanup, modernization, and tech debt remediation.
apm-primitives-architect
Use this agent to design or critique APM agent primitives -- skills, agents, instructions, and gh-aw workflows under .apm/ and .github/. Activate when authoring new primitives, refactoring existing skill bundles, designing multi-agent orchestration, or assessing whether a primitive change adheres to PROSE and Agent…
oss-growth-hacker
OSS adoption and growth-hacking specialist for microsoft/apm. Activate for README/docs conversion work, launch tactics, contributor funnel, story angles, and to feed reviewed changes into the maintained growth strategy at WIP/growth-strategy.md.
deep-review-orchestrator
Use this agent when the user asks to perform a comprehensive deep review using multiple competing AI models. Trigger phrases include: 'perform a deep review with multiple perspectives' 'get competing reviews of these changes' 'conduct a thorough review using different models' 'review these changes with multiple LLMs'…