From 90bbe6de2af245af37bfdc66796c2fa7d6dc27e0 Mon Sep 17 00:00:00 2001 From: blasty Date: Sun, 9 Aug 2026 22:55:38 +0200 Subject: Ship the idatui agent skill in-repo at .agents/skills/ Follows the Agent Skills standard (agentskills.io) rather than a contrib/ dir: harnesses discover .agents/skills//SKILL.md automatically from the repo root, and it is vendor-neutral (not .claude/ or .pi/ specific). Not a verbatim copy of the local one -- it was ~85% generic and the rest had to go before redistributing: * the backend is described as a normal pyproject dependency, with the editable-git-checkout setup demoted to a conditional note (that is one maintainer's layout, but the 'upstream pull silently swaps the backend' warning is worth keeping for anyone who does it); * personal agent tooling (bgrun/waitfor wrappers) replaced by the underlying lesson -- a backgrounded subshell holds the inherited stdout, so redirect all three fds -- which is true without those scripts; * maintainer commit authorship dropped; * absolute ~/dev paths made relative to the repo root; ~/ida-venv kept but marked as this project's assumption, matching the README. Also fixes the README's stale full-run count (788/~2m -> 1031/~50s), lists the docs that were missing from the index, and warns that a user-level skill of the same name shadows this one -- otherwise a personal copy silently wins and the in-repo copy rots. --- README.md | 18 +++++++++++++++++- 1 file changed, 17 insertions(+), 1 deletion(-) (limited to 'README.md') diff --git a/README.md b/README.md index d301c2f..5993d6b 100644 --- a/README.md +++ b/README.md @@ -175,7 +175,7 @@ test is empty while the protocol works fine). ```sh python3 tests/run.py --fast # 380 checks, <1s, any python3 — between edits python3 tests/run.py --list # what runs, and what needs IDA -python3 tests/run.py # 788 checks, ~2m — before a commit +python3 tests/run.py # 1031 checks, ~50s — before a commit ``` Every suite declares `NEEDS_IDA`; `--fast` runs only the pure ones (stdlib, no @@ -194,6 +194,22 @@ flake, and the four ways a test here wastes minutes. - [`docs/RPC.md`](docs/RPC.md) — the RPC protocol, verb by verb - [`docs/GRAPH_VIEW.md`](docs/GRAPH_VIEW.md) — how the graph is laid out +- [`docs/CODEMODE_UPSTREAM.md`](docs/CODEMODE_UPSTREAM.md) — findings from porting to + IDA Code Mode, and which are fixed upstream +- [`docs/PROJECTS.md`](docs/PROJECTS.md), [`docs/SPLIT_VIEW.md`](docs/SPLIT_VIEW.md), + [`docs/TEXTUAL_NOTES.md`](docs/TEXTUAL_NOTES.md), + [`docs/PAGING_FINDINGS.md`](docs/PAGING_FINDINGS.md), + [`docs/TRISKEL_EVAL.md`](docs/TRISKEL_EVAL.md) + +### Working on this with an LLM agent + +[`.agents/skills/idatui/SKILL.md`](.agents/skills/idatui/SKILL.md) is an +[Agent Skills](https://agentskills.io/specification) skill describing the +architecture, the run/test loop and the traps that cost real time here (Code Mode, +Textual, the graph engine, terminal graphics). Harnesses implementing that standard +discover `.agents/skills/` automatically; others can be pointed at the file directly. +A user-level skill of the same name takes precedence, so delete or symlink yours if +you keep a personal copy. — -- cgit v1.3.1-sl0p