Getting it into your agent
One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.
npx agentmods add instructions/gaelic-ghost/socket/agents-mdgit clone --depth 1 https://github.com/gaelic-ghost/socketWhat it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5 | $0.00741 | $0.00741 |
| Opus 5 | $0.00370 | $0.00370 |
| Sonnet 5 | $0.00148 | $0.00148 |
| Haiku 4.5 | $0.00074 | $0.00074 |
Grade A, and why
socket AGENTS.md scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured yesterday.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Nothing flagged
None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.
How it starts
The opening of the file, as written. The whole thing — 111 lines — stays where its author put it; the contents beside it link to each section on GitHub.
AGENTS.md
Use this file for durable Socket-specific rules. Keep procedures in contributor or maintainer documentation and implementation details in the owning child.
Repository Scope
What This File Covers
Socket is the root marketplace and coordination repository for the plugin
payloads under plugins/. The root owns marketplace metadata, shared exports,
root documentation, and cross-plugin policy.
Where To Look First
- Use
CONTRIBUTING.mdfor setup, validation, and contribution workflow. - Use
ROADMAP.mdfor current plans and recorded decisions. - Use
docs/maintainers/for release, subtree, compatibility, and installation procedures. - For child work, read the closest child
AGENTS.mdand task-owning skill.
Working Rules
Change Scope
- Keep root changes limited to one coherent cross-repository concern.
- Edit monorepo-owned payloads directly under
plugins/. - Work on Speak Swiftly in its standalone repository; Socket only references it.
- Surface any change that would widen root ownership or alter the marketplace model before implementing it.
Source of Truth
- Authored child
skills/,mcps/,apps/, and equivalent surfaces are source. - Plugin manifests and marketplace files are packaging metadata.
- Reusable scripts, templates, and contracts are versioned managed assets that the owning install or sync recipe copies into their canonical target paths.
- Gale's repository preferences are hard-coded in owning assets and skill contracts. Do not add per-user preference files, layered customization, runtime config merging, or alternate policy paths.
- Installed plugins, caches, enabled-state configuration, and consumer copies are runtime state, not editable source.
- When documentation and automation disagree, correct the owning source rather than preserving duplicate behavior.
Communication and Escalation
State the concrete ownership, compatibility, or release consequence of a change. Ask before introducing a new packaging layer, subtree-managed child, or cross-repository policy.
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- yesterday First seen · 111 lines · 741 tokens per session scan A 45afb33a4ad1
socket AGENTS.md is an instructions file published in the GitHub repository gaelic-ghost/socket (6 stars, last pushed 6d ago), licensed Apache-2.0. It adds 741 tokens to every session, about $0.0037 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.
Other instructions, from other repositories
Xcode-Disk-Cleanup-Agent-Skill AGENTS.md
Instructions for AvdLee/Xcode-Disk-Cleanup-Agent-Skill: This repository contains a safety-sensitive Agent Skill.
Peekaboo AGENTS.md
AGENTS.md instructions for openclaw/Peekaboo, covering repository guidelines, start here, project structure & modules, build, test, and development commands and coding style & naming conventions.
travel-plan-viz CLAUDE.md
Instructions for zexuanw958-svg/travel-plan-viz, covering claude.md, 这是什么, 架构红线, 测试 and 数据采集约束（写在 references/research-guide.md，改动要同步）.
skills-manager CLAUDE.md
Instructions for yibie/skills-manager, covering skills manager - development guide, tui engine: blessed, 核心原则, 参考文档 and 正确的 list 用法.
swift-tui AGENTS.md
Instructions for SwiftTUI/swift-tui, covering agents.md, build & test commands, architecture (one-page summary), development guidelines and code style.
palmier-pro CLAUDE.md
Claude Code instructions for palmier-io/palmier-pro, a project described as: macOS video editor built for AI.