agent-native-design SKILL.md skillA

agent-native-design from agents365-ai/365-skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add agents365-ai/365-skills/agent-native-design@git:20260914.72ee04b

Pins git:20260914.72ee04b in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
agents365-ai/365-skills
Path
plugins/agent-native-design/skills/agent-native-design/SKILL.md
Versions recorded
4
Latest version
git:20260914.72ee04b, committed Sep 14, 2026
First version recorded
Jul 8, 2026
Size
13,630 bytes
Repository stars
87
License
none declared

Use when designing, reviewing, or refactoring a CLI that must serve AI agents alongside humans, or when converting an API or SDK into an agent-usable CLI interface.

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

# agent-native-design

## Purpose

This skill helps analyze, design, and refactor command-line tools so they can reliably serve **humans**, **AI agents**, and **orchestration systems** at the same time.

It is not a skill for merely *using* a CLI. It is a skill for designing and reviewing a CLI as an **agent-native interface**.

The skill focuses on four goals:

1. Make CLI behavior predictable for AI agents.
2. Make CLI output readable and recoverable for humans.
3. Make CLI execution manageable for systems and orchestrators.
4. Define a complete interaction loop from authentication to error routing.

---

## When to use this skill

Use this skill when the user wants to:

* evaluate whether an existing CLI is agent-friendly
* redesign a CLI to better support AI agents
* convert an API or SDK into an agent-native CLI
* review help output, schema design, exit codes, or JSON contracts
* design dry-run, auth delegation, or safety boundaries
* generate CLI skills, docs, or interface conventions from schema
* refactor a human-oriented CLI into a machine-friendly one
* define how a CLI should interact with an agent runtime

Typical prompts include:
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add agents365-ai/365-skills/agent-native-design@sha256:35479432026b6a60

The line at the top of this page pins the label git:20260914.72ee04b, 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_eugwi5gehtqsnwot.svg)](https://markdownregistry.com/a/art_eugwi5gehtqsnwot)

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

Versions

The registry has recorded 4 versions of this file, between Jul 8, 2026 and Sep 14, 2026, about one every 23 days.

versioncommittedcommitsizeaudit
git:20260914.72ee04b latest2026-09-14 72ee04b 13,630 BA view · diff
git:20260901.ed1b35b2026-09-01 ed1b35b 13,639 BA view · diff
git:20260708.76349c52026-07-08 76349c5 12,880 BA view · diff
git:20260708.85ee60c2026-07-08 85ee60c 12,849 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 (13630 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

agents365-ai/365-skills · 87 stars · license none declared · pushed 2026-10-16 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_eugwi5gehtqsnwot
GET https://markdownregistry.com/api/v1/resolve?ref=agents365-ai/365-skills/agent-native-design
GET https://markdownregistry.com/api/v1/blob/35479432026b6a609f1488310d0af96a84bd48df7fd5f603d9619f7b54a9bd71

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 agents365-ai/365-skills

assetseeker SKILL.md skill
agents365-ai/365-skills · plugins/assetseeker/skills/assetseeker/SKILL.md · Search free commercial-use creative assets across multiple online sources — photos, illustrations, icons, video…
v1.0.0 · audit A · 87 stars
asta SKILL.md skill
agents365-ai/365-skills · plugins/asta/skills/asta-skill/SKILL.md · Query the Semantic Scholar academic corpus through AI2's Asta MCP server: keyword or title search with venue and date…
v0.4.0 · audit A · 87 stars
bangumi-frames SKILL.md skill
agents365-ai/365-skills · plugins/bangumi-frames/skills/bangumi-frames/SKILL.md · Extract and organize frames from a Bilibili video (bangumi episode, UP upload, or a local file) into scenery shots and…
v0.5.0 · audit A · 87 stars
bbc-skill SKILL.md skill
agents365-ai/365-skills · plugins/bbc/skills/bbc-skill/SKILL.md · Fetch Bilibili (哔哩哔哩) video comments for UP主 self-analysis. Use when the user asks to collect, download, export, or…
git:20261001.ee5e382 · audit A · 87 stars
excalidraw SKILL.md skill
agents365-ai/365-skills · plugins/excalidraw/skills/excalidraw-skill/SKILL.md · Use when user requests diagrams, flowcharts, architecture charts, or visualizations. Also use proactively when…
git:20261001.ee5e382 · audit A · 87 stars
figshare-skill SKILL.md skill
agents365-ai/365-skills · plugins/figshare/skills/figshare-skill/SKILL.md · Use whenever the user wants to interact with Figshare - searching public datasets/articles, downloading Figshare files…
git:20261001.ee5e382 · audit A · 87 stars
grant-thinking-cn-biology SKILL.md skill
agents365-ai/365-skills · plugins/grant-thinking-cn-biology/skills/grant-thinking-cn-biology/SKILL.md · Use when evaluating biology grant ideas in the Chinese funding context (NSFC, MOST, etc.) — diagnosing project…
git:20261001.ee5e382 · audit A · 87 stars
grant-thinking-general SKILL.md skill
agents365-ai/365-skills · plugins/grant-thinking-general/skills/grant-thinking-general/SKILL.md · Use when evaluating grant ideas, diagnosing proposal logic, framing fundable projects, strengthening reviewer-aware…
git:20261001.ee5e382 · audit A · 87 stars
imagencn SKILL.md skill
agents365-ai/365-skills · plugins/imagencn/skills/imagencn/SKILL.md · Multi-platform AI image generation via DashScope/Ark/Hunyuan/Zhipu/StepFun plus Grok/OpenAI/Gemini/FLUX…
v1.3.0 · audit A · 87 stars
journal-abbrev SKILL.md skill
agents365-ai/365-skills · plugins/journal-abbrev/skills/journal-abbrev/SKILL.md · Use when looking up journal or magazine name abbreviations, converting between full names and ISO 4/MEDLINE…
v1.3.1 · audit A · 87 stars
journal-if SKILL.md skill
agents365-ai/365-skills · plugins/journal-if/skills/journal-if/SKILL.md · Use when looking up journal impact factors (JCR IF), checking a journal's impact factor by name, comparing IF across…
v1.0.0 · audit A · 87 stars
journal-meta SKILL.md skill
agents365-ai/365-skills · plugins/journal-meta/skills/journal-meta/SKILL.md · Use when the user wants full metadata for a paper — from a DOI, PMID, arXiv id, OpenAlex id, or title. Returns title…
v0.1.0 · audit A · 87 stars

Every file in agents365-ai/365-skills

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