agents-md-init SKILL.md skillA

agents-md-init from devskale/skale-skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add devskale/skale-skills/agents-md-init@git:20261006.3723cb2

Pins git:20261006.3723cb2 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
devskale/skale-skills
Path
deprecated/agents-md-init/SKILL.md
Versions recorded
1
Latest version
git:20261006.3723cb2, committed Oct 6, 2026
Size
5,490 bytes
Repository stars
3
License
none declared

Create and update concise AGENTS.md files using proven best practices. Use when starting a new AGENTS.md, refactoring an overly long or confusing one, adding missing build/test commands, or capturing gotchas and verification steps. Triggers on: AGENTS.md, agent instructions, project guide, CLAUDE.md, cursor rules, copilot instructions, agent onboarding.

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

# AGENTS.md Best Practices

Create and update AGENTS.md files so they are short, actionable, and focused on agent success. Keep under 100 lines when possible. Include only critical commands and workflows. Capture gotchas and verification steps over time. Emphasize progressive discovery via links to deeper docs.

## References

- [references/vendor-agents-docs/](references/vendor-agents-docs/) — official docs from Anthropic, OpenAI, GitHub Copilot, and OpenCode on agent instruction files

## When to use

- Starting a new AGENTS.md
- Refactoring an overly long or confusing AGENTS.md
- Adding missing build/test commands or workflow steps
- Capturing newly discovered gotchas or verification steps

## Workflow

### Step 1: Investigate the repo

Read the highest-value sources first — prefer executable sources of truth over prose. If docs conflict with config or scripts, trust the executable source.

**Read in this order:**

1. `README*`, root manifests (`package.json`, `pyproject.toml`, etc.), workspace config, lockfiles
2. Build, test, lint, formatter, typecheck, and codegen config
3. CI workflows and pre-commit / task runner config
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add devskale/skale-skills/agents-md-init@sha256:8a1d36f8dd5e08f3

The line at the top of this page pins the label git:20261006.3723cb2, 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_wo5lbr7jwdoixqsq.svg)](https://markdownregistry.com/a/art_wo5lbr7jwdoixqsq)

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

Versions

The registry has recorded 1 version of this file, committed on Oct 6, 2026.

versioncommittedcommitsizeaudit
git:20261006.3723cb2 latest2026-10-06 3723cb2 5,490 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 (5490 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

devskale/skale-skills · 3 stars · license none declared · pushed 2026-10-18 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_wo5lbr7jwdoixqsq
GET https://markdownregistry.com/api/v1/resolve?ref=devskale/skale-skills/agents-md-init
GET https://markdownregistry.com/api/v1/blob/8a1d36f8dd5e08f32e89f4fb4ec8eee0beb4fff47c0a1ab107476a468a3e41cb

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 devskale/skale-skills

AGENTS.md AGENTS.md file
devskale/skale-skills · AGENTS.md
git:20261017.899aead · audit A · 3 stars
agent-skill-creator SKILL.md skill
devskale/skale-skills · deprecated/agent-skill-creator/SKILL.md · Guide for creating effective skills for any AI agent (Claude, Trae, Gemini, OpenCode, Qwen, etc.). This skill should be…
git:20261006.3723cb2 · audit A · 3 stars
command-creator SKILL.md skill
devskale/skale-skills · deprecated/command-creator/SKILL.md · Create custom commands for Pi (prompt templates) or OpenCode. Define command prompts, arguments, shell output…
v2.0.0 · audit A · 3 stars
improve-skill SKILL.md skill
devskale/skale-skills · deprecated/improve-skill/SKILL.md · Analyze coding agent session transcripts to improve existing skills or create new ones. Use when asked to improve a…
git:20261006.3723cb2 · audit A · 3 stars
readme-write SKILL.md skill
devskale/skale-skills · deprecated/readme-write/SKILL.md · Create and update README.md files with proper structure, badges, and sections.
git:20261006.3723cb2 · audit A · 3 stars
todo SKILL.md skill
devskale/skale-skills · deprecated/todo/SKILL.md · Create and manage TODO.md task tracking files for complex multi-step work. Use when starting a larger task that…
git:20261006.3723cb2 · audit A · 3 stars
viewimg SKILL.md skill
devskale/skale-skills · deprecated/viewimg/SKILL.md · DEPRECATED — use `read img.jpg` or `read_image` instead. Display an image in the terminal (view-only, no VLM). Renders…
v0.1.0 · audit A · 3 stars
d2 SKILL.md skill
devskale/skale-skills · skills/d2/SKILL.md · Draw architecture, sequence, flowchart, or ER diagrams as code with the D2 CLI. Use when the user wants to create…
v1.4.1 · audit A · 3 stars
fetch-url SKILL.md skill
devskale/skale-skills · skills/fetch-url/SKILL.md · Bash skill — run `fetch-url "url"` in your shell (not an MCP tool). Fetch and extract readable text from any web page…
v2.9.0 · audit A · 3 stars
figure SKILL.md skill
devskale/skale-skills · skills/figure/SKILL.md · Draw hand-drawn-style architecture or workflow figures (sketchy Excalidraw look) as SVG + PNG from a small .fig.mjs…
v1.2.1 · audit A · 3 stars
improve-ux SKILL.md skill
devskale/skale-skills · skills/improve-ux/SKILL.md · Improve UI/UX grounded in curated reference sites, with a ratings loop and findings ledger. Use when polishing a…
v0.4.0 · audit A · 3 stars
issues SKILL.md skill
devskale/skale-skills · skills/issues/SKILL.md · Manage the cross-machine shared issue kanban (works/<project>/issues/). Create, triage, start, review, cancel, archive…
v1.5.1 · audit A · 3 stars

Every file in devskale/skale-skills

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