HK-hub/AgentSkills / agent-native-design
agent-native-design
VerifiedUse 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.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 12.6 KB |
| agents/openai.yaml | config | 1.1 KB |
| references/checklists.md | markdown | 3.6 KB |
| references/citations.md | markdown | 3.7 KB |
| references/design-patterns.md | markdown | 12.4 KB |
| references/examples.md | markdown | 8.1 KB |
| references/hybrid-mcp-cli.md | markdown | 3.9 KB |
| references/rubric.md | markdown | 3.5 KB |
| references/testing.md | markdown | 11.9 KB |
| scripts/validate-metadata.sh | script | 2.7 KB |
scripts/validate-metadata.sh
View on GitHub#!/usr/bin/env bash
set -euo pipefail
root_dir="$(cd "$(dirname "${BASH_SOURCE[0]}")/../../.." && pwd)"
cd "$root_dir"
assert_contains() {
local file="$1"
local pattern="$2"
if ! rg -q --fixed-strings "$pattern" "$file"; then
echo "Missing expected text in $file: $pattern" >&2
exit 1
fi
}
assert_contains docs/install.md 'skills/agent-native-design ~/.codex/skills/'
assert_contains docs/install.md 'skills/agent-native-design .codex/skills/'
assert_contains docs/install_CN.md 'skills/agent-native-design ~/.codex/skills/'
assert_contains docs/install_CN.md 'skills/agent-native-design .codex/skills/'
assert_contains skills/agent-native-design/SKILL.md 'Includes sidecar metadata for OpenClaw, Hermes, pi-mono, and OpenAI Codex'
assert_contains README.md 'includes metadata for the platforms listed below'
assert_contains README_CN.md '并为下列平台提供元数据'
assert_contains skills/agent-native-design/SKILL.md 'Use the 14-criterion rubric to score the CLI.'
assert_contains skills/agent-native-design/SKILL.md 'Report the 14-criterion rubric score first'
assert_contains skills/agent-native-design/agents/openai.yaml 'Score a CLI on the 14-criterion rubric and summarize the seven design principles'
test -f LICENSE || {
echo 'LICENSE file is missing' >&2
exit 1
}
# Verify SKILL.md frontmatter version is not behind the latest reachable git tag.
# Catches the v1.0.1-style drift where a tag is cut without bumping the
# `version` field in the SKILL.md frontmatter metadata block.
verify_frontmatter_version_against_tag() {
local fm_version
fm_version=$(rg -oN '"version":"([0-9]+\.[0-9]+\.[0-9]+)"' skills/agent-native-design/SKILL.md -r '$1' | head -1 || true)
if [ -z "$fm_version" ]; then
echo 'SKILL.md frontmatter is missing a "version":"X.Y.Z" field' >&2
exit 1
fi
local latest_tag
latest_tag=$(git describe --tags --abbrev=0 2>/dev/null || true)
if [ -z "$latest_tag" ]; then
return 0 # no tags reachable; nothing to compare against (e.g. shallow clone)
fi
local tag_version="${latest_tag#v}"
if [ "$fm_version" = "$tag_version" ]; then
return 0
fi
# Semver compare via sort -V; the smaller version ends up first.
local lower
lower=$(printf '%s\n%s\n' "$fm_version" "$tag_version" | sort -V | head -1)
if [ "$lower" = "$fm_version" ]; then
echo "Frontmatter version $fm_version is behind latest git tag $latest_tag." >&2
echo "Bump \"version\" in the SKILL.md frontmatter metadata to match (or exceed) the tag, then re-tag if needed." >&2
exit 1
fi
# fm_version > tag_version is fine — that's the normal pre-release state.
}
verify_frontmatter_version_against_tag
echo 'Metadata validation passed.'
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation). | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK). | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |