agent-writer

agent-writer is a skill for Claude Code, Codex from gyanranjan/polyagent-skills. It costs 69 tokens per session (733 once invoked), scanned A, original, MIT.

A guide for writing reusable instructions for AI agents and coding assistants. It covers agent definitions, skill files, and configuration in a portable format.

In plain words
What is it for?
Use it to create a new agent, define a skill, document when it should run, and specify its inputs, outputs, and related tools.
Why use it?
It provides a consistent structure for turning a repeated workflow or agent role into instructions that can be reused across projects or platforms.

Skill for Claude CodeCodex

Written for no agent in particular: nothing here depends on one.

Good fit Use it to create a new agent, define a skill, document when it should run, and specify its inputs, outputs, and related tools.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/gyanranjan/polyagent-skills/agent-writer
Install

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.

Any agent
npx skills add gyanranjan/polyagent-skills --skill agent-writer
Clone the repo
git clone --depth 1 https://github.com/gyanranjan/polyagent-skills

Made for: Claude Code, Codex.

Wrote 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.

agentmods badge for agent-writer

README.md
[![agentmods](https://agentmods.dev/badge/skills/gyanranjan/polyagent-skills/agent-writer/github.svg)](https://agentmods.dev/skills/gyanranjan/polyagent-skills/agent-writer)
Your own site
<a href="https://agentmods.dev/skills/gyanranjan/polyagent-skills/agent-writer"><img src="https://agentmods.dev/badge/skills/gyanranjan/polyagent-skills/agent-writer/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.

agentmods 80×15 button for agent-writer

Your own site · 80×15
<a href="https://agentmods.dev/skills/gyanranjan/polyagent-skills/agent-writer"><img src="https://agentmods.dev/badge/skills/gyanranjan/polyagent-skills/agent-writer.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 69 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 733 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

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.

ModelPer sessionOnce invoked
Fable 5.1 $0.00069 $0.00733
Opus 5 $0.00034 $0.00367
Sonnet 5 $0.00014 $0.00147
Haiku 4.5 $0.00007 $0.00073

Measured 9d ago against content hash 1ee4010a22e8, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-09, from the pricing page.

Security

Grade A, and why

agent-writer 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.

skills/agent-writer/SKILL.md · 92 lines

How it starts

The opening of the file, as written. The whole thing — 92 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Agent Writer

Purpose

Create new agent definitions and skill files that conform to the polyagent-skills portable format. This is the meta-skill — it creates other skills.

When to Use

  • User wants to create a new skill for the polyagent-skills library
  • User wants to define a new agent persona or workflow
  • User asks "write me a skill for X"
  • User wants to convert agent-specific instructions into portable format

When NOT to Use

  • User wants to execute a task using an existing skill (use that domain skill directly)
  • User only needs a minor edit to an existing skill file (perform targeted editing instead)

Inputs

Required:

  • What the skill/agent should do
  • When it should trigger

Optional:

  • Example inputs and expected outputs
  • Common skills it should reference
  • Agents it needs to work with

Process

Step 1: Understand Intent

Clarify what the skill should accomplish, who uses it, and what triggers it.

Step 2: Design the Skill

Plan the process steps, inputs, outputs, and edge cases.

Step 3: Write SKILL.md

Follow the Skill Format Spec exactly:

  • YAML frontmatter with name, description, tags, version
  • All required sections: Purpose, When to Use, When NOT to Use, Inputs, Process, Output Format, Quality Checks, Common Skills Used, Edge Cases
  • References to common-skills where appropriate

Step 4: Create Supporting Files

Add references/, examples/, and templates/ as needed.

Step 5: Validate Portability

Check against the portability rules:

  • No agent-specific syntax
  • Relative paths only
  • Plain Markdown only
  • Self-contained steps

Step 6: Update Adapters

Run polyagentctl sync-adapters to add the new skill to all adapter files.

Output Format

A complete skill directory: skills/<skill-name>/SKILL.md plus supporting files.

Quality Checks

  • Frontmatter name matches skills/<name>/ directory exactly
  • Trigger phrases in the description and "When to Use" are specific and testable
  • Required sections from the skill format spec are present
  • All referenced files and common-skills use valid relative paths
  • Output format is explicit enough to produce deterministic results

Read the full file on GitHub · 92 lines

Changes

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.

  1. 9d ago First seen · 92 lines · 69 tokens per session scan A 1ee4010a22e8

Subscribe to this mod's changes

agent-writer is a skill published in the GitHub repository gyanranjan/polyagent-skills (2 stars, last pushed 6mo ago), licensed MIT. It adds 69 tokens to every session and 733 once invoked, about $0.0003 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-08-31.

Related

Other skills, from other repositories

create-skill

Wizard for creating new Agent Zero skills. Guides users through creating well-structured SKILL.md files. Use when users want to create custom skills.

Gen-Verse/PAST-Bench · 33 tokens

skill-creator

A guide for creating and editing reusable instruction packages called skills. A skill gives an agent the knowledge and workflow needed for a particular kind of task.

desirecore/market · 83 tokens

create-agent

A guided skill for creating a specialized software agent with its own persona and working principles. It gathers requirements through conversation, shows a preview for confirmation, and then creates the agent.

desirecore/market · 60 tokens

design-taste-frontend

Anti-slop frontend skill for landing pages, portfolios, and redesigns. The agent reads the brief, infers the right design direction, and ships interfaces that do not look templated. Real design systems when applicable, audit-first on redesigns, strict pre-flight check.

Leonxlnx/taste-skill · 61 tokens

stitch-design-taste

Semantic Design System Skill for Google Stitch. Generates agent-friendly DESIGN.md files that enforce premium, anti-generic UI standards — strict typography, calibrated color, asymmetric layouts, perpetual micro-motion, and hardware-accelerated performance.

Leonxlnx/taste-skill · 50 tokens

image-to-code

Elite website image-to-code skill for Codex. For visually important web tasks, it must first generate the design image(s) itself, deeply analyze them, then implement the website to match them as closely as possible. In Codex, it must prefer large, readable, section-specific images instead of tiny compressed boards…

Leonxlnx/taste-skill · 116 tokens