π Add Pixee Analysis Skill#87
Open
gilday wants to merge 1 commit into
Open
Conversation
ef2f7bb to
73663e5
Compare
The pixee CLI 0.13.0 release introduced the `pixee analysis` top-level subcommand with only `view`; 0.15.0 added `list` with six filter flags; 0.16.0 rounded out the CRUD shape with `pixee analysis delete`. The audit-skills workflow caught the gap: no `skills/pixee-*/SKILL.md` claimed `cliHelp: "pixee analysis --help"`, so an agent asked to enumerate analyses, poll one to completion, follow the `analysis` HAL link from a finding's representative result, or clean up a bad analysis run was guessing. This authors `skills/pixee-analysis/SKILL.md` covering all three verbs as they exist on 0.16.0. The PREREQUISITES blockquote names `pixee-shared` and `pixee-auth`, plus cross-references to `pixee-scan` (the `analyze` verb produces the analysis UUID), `pixee-finding` (every representative result's `_links.analysis.href` points back here), and `pixee-repo` (the `--repo` resolution protocol used by `list`). `## pixee analysis list` documents the six filter flags β `--repo` (repeatable), `--branch`, `--state` (repeatable; queued/in-progress/ skipped/completed/failed), `--tool` (repeatable), `--updated-after`, and `--updated-before` β and the text-mode column set (`id, state, branch, sha, updated_at`). `## pixee analysis view` covers the headline text-mode fields and the full HAL representation under `--json`, with a nested subsection for `--watch` documenting the poll-and-narrate loop, terminal states, the exit-code-by-state contract, and the 5-second `--interval` default. `## pixee analysis delete` documents the destructive verb, the server-side cascade to findings and patches, and the absence of any client-side confirmation prompt β matching the voice in `pixee-scan`, `pixee-repo`, and `pixee-workflow`. Seven runnable examples cover the bread-and-butter calls plus three load-bearing patterns: the start-then-watch chain that captures the analysis id from `pixee scan analyze`'s stdout, the HAL walk that reads `representative-results._links.analysis.href` from `pixee finding view --json` and hands it to `pixee api`, and the cascading delete. Best-practices bullets capture filter-aggressively discipline on `list`, when to prefer the analysis UUID from the start call over a list lookup, when to reach for `--watch`, `--interval` sizing, the "don't hand-roll polling" guidance, the HAL preference, how analysis UUIDs relate to the seven-day scan expiration, and the delete-cascade warning. The picker description is verb-first and picker-safe at 116 chars: "List, view, and delete Pixee analyses with filters and optional polling until the analysis reaches a terminal state." The README bullet is placed between `pixee-scan` and `pixee-finding` to match the lifecycle order (scan β analysis β finding). /close ISS-7253
73663e5 to
4400e7e
Compare
|
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.



The pixee CLI 0.13.0 release introduced the
pixee analysistop-level subcommand with onlyview; 0.15.0 addedlistwith six filter flags; 0.16.0 rounded out the CRUD shape withpixee analysis delete. The audit-skills workflow caught the gap: noskills/pixee-*/SKILL.mdclaimedcliHelp: "pixee analysis --help", so an agent asked to enumerate analyses, poll one to completion, follow theanalysisHAL link from a finding's representative result, or clean up a bad analysis run was guessing.This PR adds
skills/pixee-analysis/SKILL.mdcovering all three verbs as they exist on 0.16.0. The PREREQUISITES blockquote namespixee-sharedandpixee-auth, plus cross-references topixee-scan(theanalyzeverb produces the analysis UUID),pixee-finding(every representative result's_links.analysis.hrefpoints back here), andpixee-repo(the--reporesolution protocol used bylist).## pixee analysis listdocuments the six filter flags β--repo(repeatable),--branch,--state(repeatable; queued/in-progress/skipped/completed/failed),--tool(repeatable),--updated-after, and--updated-beforeβ and the text-mode column set (id, state, branch, sha, updated_at).## pixee analysis viewcovers the headline text-mode fields and the full HAL representation under--json, with a nested subsection for--watchdocumenting the poll-and-narrate loop, terminal states, the exit-code-by-state contract, and the 5-second--intervaldefault.## pixee analysis deletedocuments the destructive verb, the server-side cascade to findings and patches, and the absence of any client-side confirmation prompt β matching the voice inpixee-scan,pixee-repo, andpixee-workflow.Seven runnable examples cover the bread-and-butter calls plus three load-bearing patterns: the start-then-watch chain that captures the analysis id from
pixee scan analyze's stdout, the HAL walk that readsrepresentative-results._links.analysis.hreffrompixee finding view --jsonand hands it topixee api, and the cascading delete. Best-practices bullets capture filter-aggressively discipline onlist, when to prefer the analysis UUID from the start call over a list lookup, when to reach for--watch,--intervalsizing, the "don't hand-roll polling" guidance, the HAL preference, how analysis UUIDs relate to the seven-day scan expiration, and the delete-cascade warning.The picker description is verb-first and picker-safe at 116 chars: "List, view, and delete Pixee analyses with filters and optional polling until the analysis reaches a terminal state." The README bullet is placed between
pixee-scanandpixee-findingto match the lifecycle order (scan β analysis β finding)./close ISS-7253