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 skills add event4u-app/agent-config --skill guideline-writinggit clone --depth 1 https://github.com/event4u-app/agent-configWrote this? Show the measurements
A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.
[](https://agentmods.dev/skills/event4u-app/agent-config/guideline-writing)<a href="https://agentmods.dev/skills/event4u-app/agent-config/guideline-writing"><img src="https://agentmods.dev/badge/skills/event4u-app/agent-config/guideline-writing/github.svg" alt="Measured on agentmods" height="20"></a>Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.
<a href="https://agentmods.dev/skills/event4u-app/agent-config/guideline-writing"><img src="https://agentmods.dev/badge/skills/event4u-app/agent-config/guideline-writing.svg" alt="Reviewed on agentmods" width="80" height="20"></a>- NVIDIA SkillSpector pass
What 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.1 | $0.00042 | $0.01704 |
| Opus 5 | $0.00021 | $0.00852 |
| Sonnet 5 | $0.00008 | $0.00341 |
| Haiku 4.5 | $0.00004 | $0.00170 |
Grade A, and why
guideline-writing 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 9d 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 — 198 lines — stays where its author put it; the contents beside it link to each section on GitHub.
guideline-writing
When to use
- Creating a new guideline in
docs/guidelines/{topic}/{name}.md - Rewriting an existing guideline (not a typo fix)
- Extracting reference material out of a bloated skill or rule
- Consolidating repeated explanations from multiple skills
Do NOT use this skill when:
- The content is a constraint ("never / always") → use
rule-writing - The content is a triggered workflow → use
skill-writing - The content is a user-invoked action → use
command-writing
Guideline vs rule vs skill — critical test
| Intent | Artifact |
|---|---|
| "Here is knowledge skills and rules may cite" | Guideline |
| "Agent must always / never do X" | Rule |
| "When Y happens, run these steps" | Skill |
A guideline is reference material. It is never a trigger. It has no
description used for routing — skills and rules link to it.
Procedure
0. Run the Drafting Protocol
Creating or materially rewriting a guideline must go through Understand
→ Research → Draft from the
artifact-drafting-protocol rule.
- Understand — which skills or rules will cite this guideline? If the answer is "none", the guideline has no home — stop.
- Research — inspect
docs/guidelines/for overlap and grepsrc/for pages that already cover the topic. Analyze 1–2 peer guidelines in the same topic folder for tone. - Draft — propose location (topic folder + filename) and outline. Only fill bodies once the outline is confirmed.
1. Pick the right topic folder
Folders under docs/guidelines/:
| Folder | Contents |
|---|---|
agent-infra/ |
Cross-cutting agent-system knowledge (naming, size, output patterns) |
php/ |
PHP-specific reference (patterns, services, jobs, resources) |
e2e/ |
End-to-end testing patterns |
If none fits, ask the user before creating a new folder.
2. Write frontmatter
Guidelines use a minimal frontmatter — no type, no auto-trigger semantics.
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.
- 9d ago First seen · 198 lines · 42 tokens per session scan A 25454d6f08f7
guideline-writing is a skill published in the GitHub repository event4u-app/agent-config (10 stars, last pushed today), licensed MIT. It adds 42 tokens to every session and 1,704 once invoked, about $0.0002 per session on Opus 5. 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-09-03.
Other skills, from other repositories
bazel-build-optimization
Optimize Bazel builds for large-scale monorepos. Use when configuring Bazel, implementing remote execution, or optimizing build performance for enterprise codebases.
sdd-tasks
Break an SDD change into implementation tasks. Trigger: orchestrator launches task planning for a change.
contact-cache
Track all identified/contacted people across strategies. CSV-backed contact database with dedup by LinkedIn URL or email. Prevents duplicate outreach when running strategies on a recurring cadence.
pad
Talk to your project. Natural-language project management — create items, check status, plan work, brainstorm ideas, and more.
pm-arch
Skill "pm-arch" from wei63w/pm-manager, covering user input, outline, done when and shared workflow (all /pm- commands).
pm-discover
Skill "pm-discover" from wei63w/pm-manager, covering user input, outline and shared workflow.