Skip to content

Commit 2022588

Browse files
timsaucerclaude
andcommitted
docs: drop audit-skill-md skill
The skill as written pushed for every public method to be mentioned in `SKILL.md`, which is the wrong goal. `SKILL.md` is a distilled agent guide of idiomatic patterns and pitfalls, not an API reference -- autoapi-generated docs and module docstrings already provide full per-method coverage. An audit pressing for 100% method coverage would bloat the skill file into a stale copy of that reference. The two checks with actual value (stale mentions in `SKILL.md`, and drift between `functions.__all__` and the categorized function list) are small enough to be ad-hoc greps at release time and do not warrant a dedicated skill. Also remove references to the skill from `AGENTS.md` and the `write-dataframe-code` skill's "Related" section. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
1 parent a892c02 commit 2022588

3 files changed

Lines changed: 0 additions & 182 deletions

File tree

.ai/skills/audit-skill-md/SKILL.md

Lines changed: 0 additions & 177 deletions
This file was deleted.

.ai/skills/write-dataframe-code/SKILL.md

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -148,5 +148,3 @@ function exposes a non-obvious option, add a short usage example.
148148
(users and agents).
149149
- `.ai/skills/check-upstream/` — audit upstream Apache DataFusion features
150150
and flag what the Python bindings do not yet expose.
151-
- `.ai/skills/audit-skill-md/` — audit the repo-root `SKILL.md` against the
152-
current public Python API and flag drift.

AGENTS.md

Lines changed: 0 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -42,9 +42,6 @@ Currently available skills:
4242
contributor-facing guide for writing idiomatic DataFrame code inside this
4343
repo (TPC-H pattern index, plan-comparison diagnostic, docstring
4444
conventions). Layers on top of the user-facing [`SKILL.md`](SKILL.md).
45-
- [`audit-skill-md`](.ai/skills/audit-skill-md/SKILL.md) — cross-reference
46-
the repo-root `SKILL.md` against the current public Python API and report
47-
new APIs needing coverage and stale mentions. Run after upstream syncs.
4845

4946
## Plan-comparison diagnostic
5047

0 commit comments

Comments
 (0)