Skip to content

HK-hub/AgentSkills / agent-native-design

agent-native-design

Verified

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.

FileKindSize
SKILL.mdskill md12.6 KB
agents/openai.yamlconfig1.1 KB
references/checklists.mdmarkdown3.6 KB
references/citations.mdmarkdown3.7 KB
references/design-patterns.mdmarkdown12.4 KB
references/examples.mdmarkdown8.1 KB
references/hybrid-mcp-cli.mdmarkdown3.9 KB
references/rubric.mdmarkdown3.5 KB
references/testing.mdmarkdown11.9 KB
scripts/validate-metadata.shscript2.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.'
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: 322kUpdated Claude CodeCodexVerifiedInstall
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: 198kUpdated Claude CodeCodexVerifiedInstall
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: 198kUpdated Claude CodeCodexVerifiedInstall
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: 198kUpdated Claude CodeCodexVerifiedInstall