writing-agent-instructions SKILL.md skillA

writing-agent-instructions from lawzava/megapowers is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add lawzava/megapowers/writing-agent-instructions@git:20261024.969f4a6

Pins git:20261024.969f4a6 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
lawzava/megapowers
Path
plugins/megapowers/skills/writing-agent-instructions/SKILL.md
Versions recorded
5
Latest version
git:20261024.969f4a6, committed Oct 24, 2026
First version recorded
Sep 30, 2026
Size
3,598 bytes
Repository stars
8
License
MIT

Use when creating, revising, or auditing an agent skill, AGENTS.md, CLAUDE.md, nested project instructions, or native harness memory, including trigger design, progressive disclosure, harness-aware scope, behavioral validation, past-session recall, session retrospectives that turn agent mistakes into instruction or tooling changes, and the per-project learning loop that scores skill outcomes and promotes or retires lessons.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# Writing Agent Instructions

Choose the smallest instruction surface that reaches the intended work:

- Put durable repository facts, commands, boundaries, and conventions in the
  nearest applicable project instruction file.
- Put reusable task judgment or a multi-step capability in a skill.
- Put rules that must execute or block an action in tests, hooks, settings, or
  a deterministic tool. Prose can guide a model but cannot enforce behavior.

Read the applicable repository instructions, nearby instruction files, code,
tests, and configured tools before drafting. For every load-bearing statement,
identify its source as direct observation, repository policy, upstream
documentation, or an explicit author decision. Remove claims that code or a
command can reveal cheaply unless their omission would repeatedly cause a bad
decision.

Write the minimum instruction that changes behavior. State the condition, the
required outcome, and any real boundary. Preserve user intent and existing
authorization. Do not turn examples, preferences, or hypothetical risks into
blanket prohibitions, approval gates, fixed workflows, or extra files. Add
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add lawzava/megapowers/writing-agent-instructions@sha256:5b079a8cfcfed934

The line at the top of this page pins the label git:20261024.969f4a6, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_ngimfd3u7dj4qczq.svg)](https://markdownregistry.com/a/art_ngimfd3u7dj4qczq)

0 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 5 versions of this file, between Sep 30, 2026 and Oct 24, 2026, about one every 6 days.

versioncommittedcommitsizeaudit
git:20261024.969f4a6 latest2026-10-24 969f4a6 3,598 BA view · diff
git:20261014.d8b50302026-10-14 d8b5030 3,406 BA view · diff
git:20261011.37727032026-10-11 3772703 3,025 BA view · diff
git:20261001.dc6e4bc2026-10-01 dc6e4bc 3,008 BA view · diff
git:20260930.14d1a272026-09-30 14d1a27 2,836 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (3598 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

lawzava/megapowers · 8 stars · license MIT · pushed 2026-11-02 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_ngimfd3u7dj4qczq
GET https://markdownregistry.com/api/v1/resolve?ref=lawzava/megapowers/writing-agent-instructions
GET https://markdownregistry.com/api/v1/blob/5b079a8cfcfed934ffb9c73f30e0c4c91916b2c3771c77be4ecf9a1d074a0bf6

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from lawzava/megapowers

AGENTS.md AGENTS.md file
lawzava/megapowers · AGENTS.md
git:20261031.bf9a9f2 · audit A · 8 stars
CLAUDE.md CLAUDE.md file
lawzava/megapowers · CLAUDE.md
git:20260905.cb9ef5b · audit B · 8 stars
autonomous-run SKILL.md skill
lawzava/megapowers · plugins/megapowers/skills/autonomous-run/SKILL.md · Use when an approved goal must continue unattended across many steps, milestones, context resets, or sessions…
git:20261024.3987e31 · audit A · 8 stars
design-and-plan SKILL.md skill
lawzava/megapowers · plugins/megapowers/skills/design-and-plan/SKILL.md · Use to specify non-trivial behavior or interfaces, resolve requirements or tradeoffs, or produce a multi-step…
git:20261021.ffb3826 · audit A · 8 stars
evidence-research SKILL.md skill
lawzava/megapowers · plugins/megapowers/skills/evidence-research/SKILL.md · Use to research a decision that needs evidence beyond the repository, such as current upstream behavior, historical…
git:20261101.662c2d5 · audit A · 8 stars
grill-me SKILL.md skill
lawzava/megapowers · plugins/megapowers/skills/grill-me/SKILL.md · Use when the user asks to be grilled, or wants a plan, decision, idea, or draft stress-tested through a structured…
git:20261014.d8b5030 · audit A · 8 stars
humanizing-prose SKILL.md skill
lawzava/megapowers · plugins/megapowers/skills/humanizing-prose/SKILL.md · Use when the task itself is to draft, rewrite, edit, or preserve human-facing prose for clarity, attribution, or…
git:20261102.8206c29 · audit A · 8 stars
independent-review SKILL.md skill
lawzava/megapowers · plugins/megapowers/skills/independent-review/SKILL.md · Use when security, auth, billing, concurrency, data integrity, or another high-stakes artifact needs adversarial review…
git:20261102.8206c29 · audit A · 8 stars
mcp-setup SKILL.md skill
lawzava/megapowers · plugins/megapowers/skills/mcp-setup/SKILL.md · Use when installing, configuring, debugging, or verifying an MCP server for a harness, or when a configured server's…
git:20261101.662c2d5 · audit A · 8 stars
megapowers-doctor SKILL.md skill
lawzava/megapowers · plugins/megapowers/skills/megapowers-doctor/SKILL.md · Use when Megapowers seems inactive or broken: a skill did not fire, the output style is missing, a hook errors or times…
git:20261102.8206c29 · audit A · 8 stars
orchestrating SKILL.md skill
lawzava/megapowers · plugins/megapowers/skills/orchestrating/SKILL.md · Use when two or more independent lanes can run in parallel, an output-only lane protects lead context from raw payload…
git:20261020.a845365 · audit A · 8 stars
safe-effects SKILL.md skill
lawzava/megapowers · plugins/megapowers/skills/safe-effects/SKILL.md · Use when preparing a deploy, message, charge, migration, destructive query, DNS change, external API write, or any…
git:20261101.662c2d5 · audit A · 8 stars

Every file in lawzava/megapowers

Browse by kind, by grade A, or by owner.