agent-md-writer

Create agent persona markdown files with explicit boundaries and verification gates.

3|1|Updated Apr 12, 2026
One-click install
npx skills add https://github.com/Cogni-AI-OU/cogni-ai-agent-skills --skill agent-md-writer
Or copy as Structured Prompt for Agentā–¼
Please help me install this Agent Skill.
Skill: agent-md-writer
Source: https://github.com/Cogni-AI-OU/cogni-ai-agent-skills/tree/main/agent-md-writer
Command: npx skills add https://github.com/Cogni-AI-OU/cogni-ai-agent-skills --skill agent-md-writer

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

agent-md-writer solves the problem of creating agent persona files that are vague, boundary-less, or too verbose, which increases hallucinations and lowers task success rates.

Core Features & Use Cases

  • Structured persona creation: Produce high-performance persona documents for agent types like *.agent.md and CLAUDE.md with clear scope, invariants, and termination logic.
  • Safety and boundary enforcement: Apply strict Always / Ask first / Never guardrails to prevent unsafe actions and activation drift.
  • Workflow standardization and pruning: Define initialization sequences, workflow contracts, verification gates, and prune fluff to reduce token usage.

Quick Start

Use the agent-md-writer skill to generate a complete specialized persona markdown file for your domain-focused agent.

Frequently Asked Questions about agent-md-writer

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I write an agent persona markdown file that reduces hallucinations?ā–¼

To reduce hallucinations in agent personas, define explicit boundaries, verification gates, and strict Always/Never constraints in the markdown file. Replacing vague instructions with invariants and termination logic keeps autonomous agents focused and prevents activation drift.

What are Always/Ask first/Never guardrails in agent persona files?ā–¼

Always/Ask first/Never guardrails are safety constraints defined in agent persona files. They explicitly dictate actions an autonomous agent must always do, request permission for, or never execute, preventing unsafe actions and activation drift during domain-specific workflows.

How do I create a workflow contract for an autonomous agent?ā–¼

You create a workflow contract by defining initialization sequences, pruning fluff to reduce token usage, and establishing strict verification gates. This standardized structure ensures the autonomous agent follows a disciplined workflow with clear termination logic.

Does my CLAUDE.md file need invariants and termination logic?ā–¼

Your CLAUDE.md file needs invariants and termination logic if you are building a narrow, domain-specific autonomous agent. Adding these elements enforces boundaries, standardizes workflows, and prevents the agent from continuing tasks past safe completion points.

What is the best way to format a domain-specific agent persona markdown?ā–¼

The best way to format an agent persona markdown is using output-only formatting without conversational wrappers. Following disciplined structure with clear scope, workflow contracts, and explicit boundaries ensures high-performance execution for autonomous agents.