Skip to content

docs(data-tools): point to cli-tools' modern-tools table, drop redundant copy#23

Merged
CybotTM merged 1 commit into
mainfrom
chore/trim-generic-bloat
Jul 12, 2026
Merged

docs(data-tools): point to cli-tools' modern-tools table, drop redundant copy#23
CybotTM merged 1 commit into
mainfrom
chore/trim-generic-bloat

Conversation

@CybotTM

@CybotTM CybotTM commented Jul 12, 2026

Copy link
Copy Markdown
Member

Part of netresearch/skill-repo-skill#157 (A23 sweep) — ticks the cli-tools / data-tools / file-search checkbox for this repo.

Rubric

Per skill-repo-skill skills/skill-repo/references/skill-quality.md § "Content value rubric", specifically the "Fact and trigger ownership" corollary: each fact has one canonical owning skill; siblings link instead of restating.

What was cut, and why

SKILL.md's standalone ## Tool Selection table (Format | Tool | Notes) was doubly redundant:

  1. Within this file — the ## Key Patterns section directly below it already headers each tool by format (### jq -- JSON (no in-place), ### yq -- YAML (in-place -i), ### mlr -- JSONL / multi-format / DSL (in-place -I), ...), so the Format->Tool mapping was stated twice in the same SKILL.md.
  2. Across repos — 4 of its 7 rows (JSON/YAML/CSV/TOML) restate the same "legacy tool replaced by X" pairs already owned by cli-tools-skill's canonical ## Preferred Modern Tools table (grep on JSON->jq, sed on YAML->yq, awk on CSV->qsv, sed on TOML->dasel).

Removed the table. This is a judgment call, not a literal read of "replace the table with a pointer" — a bare deletion would have lost two facts that exist nowhere else in the file (dasel is the only native TOML tool; xmlstarlet is the XPath alternative for XML). Folded both into the dasel Key Pattern heading instead of dropping them, and added a one-line pointer to cli-tools-skill's table for the general legacy->modern framing. Net effect: no information lost, no table duplicated.

What was kept, and why (protected)

  • Critical Rule ("NEVER use grep, sed, awk, or inline interpreters... on JSON, JSONL, YAML, TOML, XML, or CSV") — untouched. Inference-suppression, hard-protected by the task.
  • jq-no-in-place (### jq -- JSON (no in-place)) and mlr -I for in-place (### mlr -- JSONL / multi-format / DSL (in-place -I)) gotchas — untouched, in ## Key Patterns.
  • All cookbook reference files (jq-cookbook.md, yq-cookbook.md, dasel-cookbook.md, mlr-cookbook.md, csv-processing.md) — untouched; out of scope for this consolidation PR (data-tools remains the canonical owner of jq/yq/mlr/dasel/qsv transformation depth).
  • ## Anti-Patterns (BAD grep/sed/awk/python3-inline -> GOOD jq/yq/qsv) — kept; reinforces the Critical Rule with concrete failure examples (category 5, inference suppression, protected even though it reads as prose per the rubric's explicit protection).

Verification

$ wc -w skills/data-tools/SKILL.md
453 skills/data-tools/SKILL.md   # was 497 (still well under the 500-word cap either way)

$ bash <path-to>/skill-repo-skill/scripts/audit-skills.sh skills
DESCRIPTION: 315 chars [PASS]
BODY: 394 words, 96 lines [PASS]
REFERENCES: 5 total -> 5/P1 + 0/P2 + 0/P3 = 5 reachable, 0 ORPHAN
SUMMARY: 1 skills, 0 FAIL, 0 WARN, 0 INFO, 0 ORPHAN refs

$ pre-commit run --files skills/data-tools/SKILL.md
trim trailing whitespace.................................................Passed
fix end of files.........................................................Passed
Validate skill repo structure............................................Passed
Plugin/SKILL/composer version parity.....................................Passed
markdownlint-cli2........................................................Passed

Do not merge — leaving for maintainer review per the sweep process.

…ant copy

Per skill-repo-skill skills/skill-repo/references/skill-quality.md
"Content value rubric" (Fact and trigger ownership): the standalone
"Tool Selection" table restated the same Format->Tool mapping already
implied by the "Key Patterns" section headers directly below it, and
duplicated cli-tools-skill's canonical Legacy/Modern table for the
grep/sed/awk-on-structured-data rows. Removed the table, folded its
two non-redundant notes (dasel is the only native TOML tool; xmlstarlet
as the XPath alternative for XML) into the dasel Key Pattern heading,
and added a pointer to cli-tools-skill's table for the general
legacy->modern comparison.

The "no grep/sed/awk on structured formats" Critical Rule and the
jq-no-in-place / mlr -I in-place gotchas in Key Patterns are untouched
(inference-suppression, protected).

Part of netresearch/skill-repo-skill#157.

Signed-off-by: Sebastian Mendel <info@sebastianmendel.de>
Copilot AI review requested due to automatic review settings July 12, 2026 06:18
@sonarqubecloud

Copy link
Copy Markdown

@github-actions

Copy link
Copy Markdown

Dependency Review

✅ No vulnerabilities or license issues or OpenSSF Scorecard issues found.

Scanned Files

None

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot was unable to review this pull request because the user who requested the review has reached their quota limit.

@gemini-code-assist gemini-code-assist Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

This pull request simplifies the skills/data-tools/SKILL.md file by removing the redundant 'Tool Selection' table and referencing the modern tools table in the cli-tools skill instead. It also adds a note about using gh --jq with the GitHub CLI and expands the dasel header. The review feedback suggests using a relative link instead of an absolute URL to reference the cli-tools markdown file, as they reside in the same repository.

Important

The consumer version of Gemini Code Assist on GitHub is being sunset. Starting June 18, 2026, new organization installations will be blocked, and all code review activity will officially cease on July 17, 2026.
For more details on the timeline and next steps, please review the Help Documentation.

Comment thread skills/data-tools/SKILL.md
@CybotTM
CybotTM merged commit a9acbc6 into main Jul 12, 2026
14 of 15 checks passed
@CybotTM
CybotTM deleted the chore/trim-generic-bloat branch July 12, 2026 07:39
@CybotTM CybotTM mentioned this pull request Jul 13, 2026
CybotTM added a commit that referenced this pull request Jul 13, 2026
- docs(data-tools): point to cli-tools' modern-tools table, drop
redundant copy (#23)
- bump plugin.json and SKILL.md metadata.version to 1.6.3
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants