Skills write-agents-md
๐Ÿ“ฆ

write-agents-md

v1.0 Content revision r1 Safe โš™๏ธ External commands

Create Evidence-Based AGENTS.md Instructions

Missing or outdated repository instructions leave coding agents without reliable commands and editing boundaries. This skill drafts concise instructions from repository evidence and adds a CLAUDE.md bridge.

Supports: Claude Codex Code(CC)
Maintain this Skill? Claim it ๐Ÿ“Š 75 Adequate

Install with my Agent

Copy this request to your Agent. It includes the canonical Skill page and manifest.

Agent request
Review the Skillstore skill "write-agents-md" from https://skillstore.io/skills/agentkitco-write-agents-md.md and its manifest at https://skillstore.io/api/skills/agentkitco-write-agents-md/manifest. Verify the artifact. You may proceed after verification, subject to the environment's own policy.

Your Agent should still show its plan and request any confirmation required by the security policy.

Agent-readable resources

Use these links when an AI agent, crawler, or script needs clean context instead of reading the full page.

Test it

Using "write-agents-md". Create instructions for a repository with documented test commands and generated source files.

Expected outcome:

  • Commands: Include repository-backed installation, development, testing, linting, and build steps.
  • Boundaries: Identify generated source files that must not be edited manually.
  • Open questions: Record any setup details that could not be verified.
  • Verification: Report commands checked and commands skipped.

Using "write-agents-md". Consolidate overlapping AGENTS.md and CLAUDE.md guidance without losing unique project rules.

Expected outcome:

  • AGENTS.md: Shared commands, conventions, editing boundaries, and completion requirements.
  • CLAUDE.md: An import of AGENTS.md with any unique guidance preserved.
  • Final report: Updated files, verification results, and remaining owner questions.

Security Audit

Safe
v1 โ€ข 10/17/2026 Open versioned report

All 14 static findings are false positives: Markdown backticks format documentation, the environment-file reference prohibits committing secrets, and the personal-path reference prohibits disclosure. The workflow requests repository inspection, instruction-file edits, and command verification with explicit safety limits. No evidence found of prompt injection, credential collection, data exfiltration, or malicious execution in the two reviewed files.

2
Files scanned
78
Lines analyzed
0
Review items
0
False positives ignored
No confirmed security findings were detected by the latest completed static and semantic audit. This does not prove the skill has no side effects.
Audited by: codex
Share & cite this report

Share the versioned assessment report, neutral badge, embed card, and citations. Skillstore reports evidence without deciding whether this Skill is safe.

Open versioned report
Security Assessment

Copy report link

https://skillstore.io/skills/agentkitco-write-agents-md/audits/1?utm_source=security_passport&utm_medium=share&utm_campaign=versioned_report

Markdown badge

[![Skillstore security assessment](https://skillstore.io/badges/skills/agentkitco-write-agents-md/security.svg)](https://skillstore.io/skills/agentkitco-write-agents-md?utm_source=security_passport_badge)

HTML badge

<a href="https://skillstore.io/skills/agentkitco-write-agents-md?utm_source=security_passport_badge"><img src="https://skillstore.io/badges/skills/agentkitco-write-agents-md/security.svg" alt="Skillstore security assessment" loading="lazy"></a>

Embed card

<iframe src="https://skillstore.io/embed/skills/agentkitco-write-agents-md.html" title="Skillstore Security Assessment" sandbox="allow-popups allow-popups-to-escape-sandbox" loading="lazy" referrerpolicy="no-referrer" width="420" height="180"></iframe>
Academic citations (APA ยท BibTeX ยท CFF)

APA citation

agentkitco. (2026). write-agents-md security audit report (audit version 1) [Author version 1.0]. Skillstore. https://skillstore.io/skills/agentkitco-write-agents-md/audits/1

BibTeX citation

@techreport{agentkitco-agentkitco-write-agents-md-2026, author = {agentkitco}, title = {write-agents-md security audit report (audit version 1)}, institution = {Skillstore}, year = {2026}, number = {1}, url = {https://skillstore.io/skills/agentkitco-write-agents-md/audits/1}, note = {Author version 1.0} }

CITATION.cff

cff-version: 1.2.0 message: "If you use this Skill, cite its author and this versioned security audit report." title: "write-agents-md security audit report (audit version 1)" version: "1.0" type: report authors: - name: "agentkitco" date-released: "2026-10-17" url: "https://skillstore.io/skills/agentkitco-write-agents-md/audits/1" identifiers: - type: other value: "skillstore:agentkitco-write-agents-md:audit:1" description: "Skillstore immutable audit report identifier"

Skillstore Score

Why this score Evidence Confidence: Medium
41
Architecture
85
Maintainability
87
Content
65
Community
91
Spec Compliance

What You Can Build

Document a New Agent Workflow

Create initial repository instructions from existing documentation, scripts, and CI checks.

Consolidate Team Instructions

Rewrite duplicated agent guidance into AGENTS.md and connect Claude Code through a shared import.

Clarify Project Boundaries

Record generated files, approval requirements, test commands, and unanswered setup questions for contributors.

Try These Prompts

Create Initial Instructions
Create AGENTS.md for this repository using verified evidence. Add a CLAUDE.md bridge and list unresolved questions.
Refresh Existing Guidance
Rewrite our AGENTS.md using current manifests and CI configuration. Verify safe commands, preserve project boundaries, and report skipped checks.
Merge Tool Instructions
Review existing agent instruction files. Consolidate duplicated guidance into AGENTS.md, preserve unique rules, and update CLAUDE.md with an import.
Organize Scoped Instructions
Create concise root instructions and scoped AGENTS.md files where needed. Verify paths and safe commands; flag unknowns and approval-required operations.

Best Practices

  • Use manifests, CI configuration, and existing documentation as evidence for every project-specific instruction.
  • Review repository-defined commands before verification and keep destructive operations behind explicit approval.
  • Keep shared instructions concise, preserve unique existing rules, and record unknowns as owner TODOs.

Avoid

  • Inventing commands, paths, or conventions when repository evidence is missing.
  • Copying secrets, personal paths, or duplicated guidance into instruction files.
  • Running destructive commands during verification or committing documentation changes without a request.

Frequently Asked Questions

What does this skill create?
It drafts or rewrites AGENTS.md and creates or updates a CLAUDE.md import bridge.
Where does it find project facts?
It reviews documentation, manifests, CI configuration, lint settings, directory layout, and existing agent instruction files.
Does it execute project commands?
The workflow verifies documented commands, limits execution to safe operations, and skips destructive commands. Review repository scripts before execution.
How does it handle missing information?
It records owner TODOs instead of guessing and lists unresolved questions in its final message.
Can it update existing instructions?
Yes. It merges existing guidance, removes duplication, and uses a CLAUDE.md import to share AGENTS.md content.
Does it commit the generated files?
No. The skill instructs the agent not to commit unless asked.

Developer Details

Author

agentkitco

License

MIT

Author version

v1.0

Skillstore revision

r1

Version notice

The author-declared version is not valid SemVer.

Ref

743429f75b17204d47661a86b577a575ad67517f

Maintenance freshness

10/17/2026

Usage

0 downloads ยท 0 views

File structure

๐Ÿ“ references/

๐Ÿ“„ template.md

๐Ÿ“„ SKILL.md

More from agentkitco

View all
View all