All skills
simota avatar

/hone

@c805268
by shingo imotasimota/agent-skills85 stars
15

Auditing AI CLI configs and designing, configuring, or debugging Claude Code hooks. Use for Codex/agy/Claude Code config reviews, hook lifecycle automation, quality gates, or MCP governance.

Use this Skill: https://skilld.dev/gh/simota/agent-skills/hone

This session only. Nothing lands on disk.

referencehandoffs.md

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

Handoff Templates

Purpose: Templates for collaboration handoffs between Hone and other agents. Read when: Hone needs to delegate or receive work from partner agents.


Incoming Handoffs

From User (Direct Request)

HONE_AUDIT_REQUEST:
  target_cli: codex | agy | antigravity | claude-code | all  # default: all
  scope: full | model | trust | features | mcp | rules | agents | instructions | safety | extensions | permissions | commands | hooks
  config_path: "~/.codex/ | ~/.gemini/ | ~/.claude/"  # default: based on target_cli
  focus: ""  # optional specific concern
  depth: quick | standard | deep  # default: standard

From Nexus (Task Context)

_AGENT_CONTEXT:
  Role: Hone
  Task: "Audit and optimize Codex CLI configuration"
  Mode: AUTORUN
  Chain: [previous] → Hone → [next]
  Input:
    scope: [audit scope]
    concerns: [specific areas]
  Constraints:
    - [constraint 1]
  Expected_Output:
    - Audit report with proposals

From Builder (Environment Context)

BUILDER_TO_HONE_HANDOFF:
  environment:
    os: [macOS/Linux]
    shell: [zsh/fish/bash]
    codex_version: [version]
    config_path: [path]
  target_cli: [codex | agy | antigravity | claude-code | all]
  context: "Environment setup complete, AI CLI config needs optimization"
  findings: [relevant Builder findings about CLI tools]

Outgoing Handoffs

To Hone (Shell Integration)

When Hone discovers that Codex config changes require shell environment updates:

HONE_TO_BUILDER_HANDOFF:
  context: "Codex configuration changes may require shell/environment updates"
  findings:
    - type: [shell_alias | env_var | path_update]
      description: "[what needs to change]"
      current: "[current state]"
      proposed: "[desired state]"
  priority: P{0-3}
  action_needed: "[specific Builder action]"

To Judge (Review Config Verification)

When Hone identifies that Codex review settings need validation:

HONE_TO_JUDGE_HANDOFF:
  context: "Codex review configuration has been audited"
  config_changes:
    - setting: "[config key]"
      before: "[old value]"
      after: "[proposed value]"
  verification_needed: "Confirm codex review behavior with proposed settings"

To Nexus (Results Return)

HONE_TO_NEXUS_HANDOFF:
  summary: "[1-3 line audit summary]"
  proposals:
    p0_count: [n]
    p1_count: [n]
    p2_count: [n]
    p3_count: [n]
  critical_findings: ["[finding 1]", "[finding 2]"]
  next_action: "[recommended follow-up]"
  suggested_agent: "[Agent name if handoff needed]"

Handoff Decision Matrix

Finding type Handoff to When
Shell/env changes needed Hone Config requires PATH, alias, or env var changes
Review settings changed Judge codex review behavior may be affected
Security concern found Sentinel Plaintext secrets, permission issues
Complex multi-agent task Nexus Findings span multiple agent domains
No handoff needed User All proposals are self-contained

Source: SKILL.md on GitHub

1 warning13d4 checks · Risk SAFE
  • Gen Agent Trust Hub13d

    The skill is a security-focused configuration auditor and automation tool for AI CLI environments. It includes extensive features for detecting hardcoded secrets, blocking dangerous shell commands, and managing environment security through best practices. No malicious patterns were detected.

  • Socket13d

    No alerts

  • Snyk13d

    Risk: LOW · No issues

  • ZeroLeaks5mo

    1 finding · Score: 78/100

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

Last checked against GitHub 2 days ago.

Activeupdated 2 weeks ago

README badge

README badge for simota/agent-skills/hone