Skillget

agent-native-cli

agent
Security Audit
Warn
Health Warn
  • License — License: MIT
  • Description — Repository has a description
  • Active repo — Last push 0 days ago
  • Low visibility — Only 5 GitHub stars
Code Pass
  • Code scan — Scanned 3 files during light audit, no dangerous patterns found
Permissions Pass
  • Permissions — No dangerous permissions requested
Purpose
This tool is a knowledge-based design and review skill that helps developers build Command Line Interfaces (CLIs) optimized for both humans and AI orchestration systems. It provides structured guidelines and rubrics rather than performing active code execution.

Security Assessment
Overall Risk: Low. The automated code scan checked three files and found no dangerous patterns, hardcoded secrets, or requests for risky permissions. Because this is a shell-based agent skill, it acts primarily as a set of instructions (a prompt framework) for AI platforms rather than a standalone executable. It does not appear to make independent network requests, execute arbitrary shell commands, or access sensitive user data.

Quality Assessment
The repository uses the permissive MIT license and was actively updated recently (last push was today). However, it currently has very low community visibility, with only 5 GitHub stars. This indicates that while the project is actively maintained by its creator, it has not yet been widely peer-reviewed or battle-tested by a large open-source community.

Verdict
Safe to use. The code is completely free of dangerous patterns, though developers should keep in mind that its guidelines are highly experimental and lack extensive community validation.
SUMMARY

Agent-Native CLI design & review skill — design CLIs that serve humans, AI agents, and orchestration systems simultaneously

README.md

agent-native-cli — Agent-Native CLI Design & Review Skill

中文文档 · Docs site

What it does

  • Evaluates whether an existing CLI is reliably usable by AI agents
  • Designs CLI interfaces that serve humans, agents, and orchestration systems simultaneously
  • Converts REST APIs and SDKs into agent-native CLI command trees
  • Reviews stdout contracts, exit code semantics, and error envelope design
  • Designs schema-driven self-description, dry-run previews, and schema introspection
  • Defines safety tiers (open / warned / hidden) for graduated command visibility
  • Designs delegated authentication so agents never own the auth lifecycle
  • Produces prioritized refactor plans with concrete interface examples

Multi-Platform Support

The core SKILL.md is portable, and this repository includes metadata for the platforms listed below:

Platform Status Details
Claude Code ✅ Full support Native SKILL.md format
OpenClaw / ClawHub ✅ Full support metadata.openclaw namespace
Hermes Agent ✅ Full support metadata.hermes namespace, category: engineering
pi-mono ✅ Full support metadata.pimo namespace
OpenAI Codex ✅ Full support agents/openai.yaml sidecar
SkillsMP ✅ Indexed GitHub topics configured

Comparison: with vs. without this skill

Capability Native agent This skill
Evaluate whether a CLI is agent-native No Yes — structured diagnosis across 7 principles
Design stdout JSON contract Inconsistent Always — stable envelope with ok, data, error
Define exit code semantics Ad hoc Yes — documented, deterministic per failure class
Design layered --help and schema introspection No Yes — full self-description pattern
Design dry-run previews Rarely Always — request shape preview without execution
Define safety tiers for commands No Yes — open / warned / hidden tiers
Design delegated authentication No Yes — human manages auth lifecycle; agent uses token
Separate trust levels for env vs. CLI args No Yes — directional trust model
Produce prioritized refactor plan Rarely Always — P0 / P1 / P2 with examples
Score CLI across 14-criterion rubric No Yes — 0–2 per criterion with verdict

When to use

  • Evaluating whether an existing CLI is usable by an AI agent
  • Designing a new CLI interface for an API or SDK
  • Refactoring a human-first CLI to be machine-readable
  • Reviewing stdout, stderr, and exit code contract design
  • Defining dry-run, schema introspection, and self-description layers
  • Designing auth delegation and trust boundaries for agent safety
  • Producing a SKILL.md or skill docs from a CLI schema

Skill Installation

Quick install — ask any agent

The simplest install is to ask any code-capable agent (Claude Code, Codex, Cursor, Aider, Gemini CLI, …) to clone the repo into your platform's skills directory. Just hand it the URL and the destination path:

Clone https://github.com/Agents365-ai/agent-native-cli into ~/.claude/skills/agent-native-cli for me.

Substitute the destination for your platform — see the Installation paths summary table at the end of this section. Because the prompt names the exact path, this works for any agent regardless of whether it has built-in knowledge of skills conventions. For environments without an agent handy (CI, fresh machines, headless scripts), use the per-platform git clone commands in the sub-sections that follow.

Claude Code

# Global install (available in all projects)
git clone https://github.com/Agents365-ai/agent-native-cli.git ~/.claude/skills/agent-native-cli

# Project-level install
git clone https://github.com/Agents365-ai/agent-native-cli.git .claude/skills/agent-native-cli

OpenClaw / ClawHub

# Via ClawHub
clawhub install agent-native-cli

# Manual install
git clone https://github.com/Agents365-ai/agent-native-cli.git ~/.openclaw/skills/agent-native-cli

# Project-level install
git clone https://github.com/Agents365-ai/agent-native-cli.git skills/agent-native-cli

Hermes Agent

git clone https://github.com/Agents365-ai/agent-native-cli.git ~/.hermes/skills/engineering/agent-native-cli

Or add to ~/.hermes/config.yaml:

skills:
  external_dirs:
    - ~/myskills/agent-native-cli

pi-mono

git clone https://github.com/Agents365-ai/agent-native-cli.git ~/.pimo/skills/agent-native-cli

OpenAI Codex

# User-level install (default CODEX_HOME)
git clone https://github.com/Agents365-ai/agent-native-cli.git ~/.codex/skills/agent-native-cli

# Project-level install
git clone https://github.com/Agents365-ai/agent-native-cli.git .codex/skills/agent-native-cli

SkillsMP

skills install agent-native-cli

Installation paths summary

Platform Global path Project path
Claude Code ~/.claude/skills/agent-native-cli/ .claude/skills/agent-native-cli/
OpenClaw ~/.openclaw/skills/agent-native-cli/ skills/agent-native-cli/
Hermes Agent ~/.hermes/skills/engineering/agent-native-cli/ Via external_dirs config
pi-mono ~/.pimo/skills/agent-native-cli/ —
OpenAI Codex ~/.codex/skills/agent-native-cli/ .codex/skills/agent-native-cli/

Files

  • SKILL.md — the core skill instructions. This is the primary file across platforms.
  • agents/openai.yaml — OpenAI Codex-specific configuration (display, policy, capabilities)
  • README.md — this file (English)
  • README_CN.md — Chinese documentation

Note: SKILL.md is the portable core. Some platforms, including OpenAI Codex, can also use sidecar metadata such as agents/openai.yaml.

GitHub Topics

For SkillsMP indexing, this repository uses the following topics:

claude-code claude-code-skill claude-skills agent-skills agent-native agent-native-cli openclaw openclaw-skills skillsmp skill-md cli cli-design interface-design structured-output schema-driven dry-run exit-codes tool-design

License

MIT

Support

If this skill helps your work, consider supporting the author:

WeChat Pay
WeChat Pay 		Alipay
Alipay 		Buy Me a Coffee
Buy Me a Coffee

Author

Agents365-ai

Reviews (0)

No results found