ivy/agents-local-md
.claude/skills/agents-local-md/SKILL.md
Generate machine-specific AGENTS.local.md with host facts and system tool details
$ install --global
skillsauthnpx skillsauth add ivy/dotfiles agents-local-mdInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 16, 2026, 11:00 AM17.1s1 file scanned
SKILL.md
- name:
- agents-local-md
- description:
- Generate machine-specific AGENTS.local.md with host facts and system tool details
- argument-hint:
- [--force]
- disable-model-invocation:
- true
- - Bash(uname:
- *)
- - Bash(hostname:
- *)
- - Bash(command -v:
- *)
- - Bash(which:
- *)
- - Bash(zsh --version:
- *)
- - Bash(tmux -V:
- *)
- - Bash(nvim --version:
- *)
- - Bash(chezmoi data:
- *)
- - Bash(readlink:
- *)
- - Bash(test -f:
- *)
- - Bash(test -L:
- *)
- - Bash(cat /etc/os-release:
- *)
- - Bash(stat:
- *)
- - Bash(date:
- *)
- # NOTE:
- Write and ln require user approval (intentional)
Generate AGENTS.local.md
Probe this machine's environment and write AGENTS.local.md — a machine-specific context file that Claude Code auto-loads via CLAUDE.local.md symlink.
Arguments
$ARGUMENTS
Options:
--force— regenerate even if the file is fresh
Instructions
1. Freshness Check
If AGENTS.local.md exists in the repo root:
stat -c %Y AGENTS.local.md 2>/dev/null || stat -f %m AGENTS.local.md 2>/dev/null
Read the file and extract the Generated: line. If ALL of these are true, report "AGENTS.local.md is current (generated DATE on HOSTNAME)" and stop:
- File is less than 7 days old
- Hostname in file matches current hostname
- OS in file matches current OS
--forcewas NOT passed in arguments
Otherwise, continue to regenerate.
2. Probe System Identity
Gather:
uname -s # OS kernel (Darwin/Linux)
uname -m # Architecture (x86_64/arm64)
hostname -s # Short hostname
cat /etc/os-release # Linux distro details (skip on macOS)
Determine which system package manager is available:
- macOS:
command -v brew - Linux:
command -v dnforcommand -v apt
3. Probe Core System Tools
Only probe tools that vary across systems and affect agent behavior: zsh, tmux, nvim.
These are system-installed, version-significant tools where the difference between (say) zsh 5.8 vs 5.9, tmux 3.3 vs 3.5, or nvim 0.9 vs 0.11 changes what features/APIs are available. Mise-pinned tools are the same everywhere — don't list them.
For each tool, collect:
- Version:
zsh --version,tmux -V,nvim --version - Path:
command -v <tool>
4. Chezmoi Platform Detection
chezmoi data --format json | grep -E '"os"|"arch"|"hostname"'
Record what chezmoi sees — this is what drives template conditionals.
5. Write AGENTS.local.md
Write the file to the repo root (AGENTS.local.md). Target <30 lines. Use this structure:
# AGENTS.local.md
> Machine-specific context for coding agents. Auto-generated — do not edit.
> Regenerate with `/agents-local-md --force`.
Generated: YYYY-MM-DD on HOSTNAME (OS ARCH)
## System
- **OS:** Fedora 42 (Linux 6.x) / macOS 15.x (Darwin)
- **Arch:** x86_64 (amd64) / arm64
- **Hostname:** name
- **Package manager:** dnf (`/usr/bin/dnf`) / brew (`/opt/homebrew/bin/brew`)
## Core Tools
| Tool | Version | Path |
|------|---------|------|
| zsh | 5.9 | `/usr/bin/zsh` |
| tmux | 3.5a | `/usr/bin/tmux` |
| nvim | 0.11.5 | `/usr/bin/nvim` |
## Chezmoi Platform
chezmoi sees: os=`linux`, arch=`amd64`, hostname=`core`
What belongs here: facts that vary across machines and change agent behavior.
What does NOT belong:
- Mise-pinned tools (same everywhere)
- Third-party tools available in homebrew (latest everywhere)
- Facts already documented in the codebase (eza/dust Fedora gaps, mise wrapper alias)
- Session-ephemeral data (PID, uptime, load)
- Tool counts, shim counts, template counts
6. Create Symlink
ln -sf AGENTS.local.md CLAUDE.local.md
7. Verify
test -f AGENTS.local.md && echo "AGENTS.local.md exists"
test -L CLAUDE.local.md && readlink CLAUDE.local.md
git status AGENTS.local.md CLAUDE.local.md
Confirm:
AGENTS.local.mdexists with contentCLAUDE.local.mdsymlink points toAGENTS.local.md- Both are gitignored (should not appear in
git status)
Report: "Generated AGENTS.local.md (N lines) — CLAUDE.local.md symlinked. Both gitignored."
Related Skills
ivy/handoff
tools
VerifiedTrustedCommunity
Write a handoff brief summarizing the current conversation so a fresh agent can pick up the work. Writes to a file if given, otherwise copies to the clipboard.
7SKILL.mdUpdated Jun 4, 2026
ivy/mob
data-ai
VerifiedTrustedCommunity
Use when the user wants to set, change, or clear git commit co-authors for pair or mob programming.
7SKILL.mdUpdated Apr 16, 2026
ivy/hk
tools
VerifiedTrustedCommunity
Use when bootstrapping hk pre-commit hooks for a project.
7SKILL.mdUpdated Apr 16, 2026
ivy/grill-me
testing
VerifiedTrustedCommunity
Interview the user relentlessly about a plan or design until reaching shared understanding, resolving each branch of the decision tree. Use when user wants to stress-test a plan, get grilled on their design, or mentions "grill me".
7SKILL.mdUpdated Apr 16, 2026