skilld
All skills
agents365-ai avatar

/agent-native-design

@72ee04b
by Agents365.aiagents365-ai/365-skills57 stars
12

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.

Ask your Agent

Use this Skill: https://skilld.dev/gh/agents365-ai/365-skills/agent-native-design

This session only. Nothing lands on disk.

referencesrubric.md

≈892 tokens on demand. Your agent reads this file only when SKILL.md points to it.

Rubric

14 criteria, scored 0–2 each. Every criterion is tagged with the principle it backs, so scoring the rubric is the same act as auditing the seven principles. Use this when producing the score component of a CLI review.

Criterion Principle 0 — Fail 1 — Partial 2 — Pass
Three-audience support P0 Designed for only one audience (human-only, or agent-only) Serves two audiences well; the third is an afterthought or broken Deliberately designed for human + agent + system with documented trade-offs
Stdout contract P1 Prose or mixed output JSON sometimes, not always Always parseable JSON with stable envelope when stdout is not a TTY (agent context); human-readable by default only under TTY or explicit --format table
Stderr separation P1 Diagnostics mixed into stdout Some separation Diagnostics always on stderr
Exit code semantics P1/P2 All errors map to same code Some codes defined Documented, stable, distinct codes per failure class
Self-description (help) P3 No --help or single flat page Layered help exists but incomplete Full progressive help: top → resource → action → schema
Schema introspection P6 Not available Partial or undocumented tool schema <resource.action> returns full typed schema
Dry-run P3/P4 Not available Available for some commands Available for all mutating commands
Idempotent retries P1 Mutating commands have no idempotency story; retries create duplicates --idempotency-key exists on some commands, or retry semantics are inconsistent Every mutating command accepts --idempotency-key; retried calls return the original result; the retryable flag in the error envelope is meaningful and correct
Non-interactive operation P0 CLI prompts on confirmation or password input regardless of TTY state; no --yes/--force flags Some commands support --yes but TTY detection is incomplete or pagers still block CLI never prompts when stdin is not a TTY; --yes / --no-input supported on every confirmation; pagers disabled when stdout is not a TTY; structured confirmation_required error returned instead of blocking
Safety tiers P4 Destructive ops at same level as reads Some warning on destructive ops Read/write/destructive clearly tiered; destructive hidden from skills
Boundary validation P5 Validation scattered across internal functions, or missing Boundary validation exists but internal code still re-validates or accepts raw input All input validated once at the CLI entry point; internal code operates on typed, trusted structures; validators are centralized and tested for pass and reject cases
Auth delegation P7 Agent manages token lifecycle, runs login or token-retrieval subcommands Token via env var but refreshed by the agent Human/system manages token acquisition and refresh; agent receives a pre-fetched credential and never invokes the auth retrieval path
Error recoverability P1 No error fields code + message only code + message + retryable + context fields
Trust boundary P2 CLI args used for auth/config Mixed Env vars / config set by human; agent supplies only runtime params

Scoring guide (max 28):

  • 26–28: Agent-native
  • 17–25: Partially agent-native — specific gaps, actionable fixes
  • 0–16: Not yet agent-native — structural redesign needed

Source: SKILL.md on GitHub

Third-party checks

No alerts17d3 checks · Risk SAFE
  • Gen Agent Trust Hub17d

    This skill provides design principles, rubrics, and technical guidelines for creating 'agent-native' command-line interfaces. It includes comprehensive documentation on structured output, safety tiers, and delegated authentication, as well as template scripts for testing and metadata validation. No malicious patterns or security risks were identified.

  • Socket17d

    No alerts

  • Snyk17d

    Risk: LOW · No issues

Provenance

Signed by skilld at 72ee04b. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub 15 hours ago.

Activeupdated 3 weeks ago

Capability

homepage
https://github.com/Agents365-ai/365-skills
platforms
[
  "macos",
  "linux",
  "windows"
]
Other metadata
compatibility
Includes sidecar metadata for OpenClaw, Hermes, pi-mono, and OpenAI Codex; the core SKILL.md is portable to any agent runtime that supports Agent Skills-style instructions.
metadata
{
  "openclaw": {
    "requires": {},
    "emoji": "⌨️",
    "os": [
      "darwin",
      "linux",
      "win32"
    ]
  },
  "hermes": {
    "tags": [
      "cli",
      "agent-native",
      "interface-design",
      "structured-output",
      "schema-driven"
    ],
    "category": "engineering",
    "requires_tools": [],
    "related_skills": []
  },
  "pimo": {
    "category": "engineering",
    "tags": [
      "cli",
      "agent-native",
      "interface-design",
      "structured-output",
      "schema-driven"
    ]
  },
  "author": "Agents365-ai",
  "version": "1.4.0"
}

README badge

README badge for agents365-ai/365-skills/agent-native-design