{"slug":"fluxcd-flux-controller-patch-releases","name":"flux-controller-patch-releases","description":"Run the upstream Flux controller patch release procedure for helm-controller, image-automation-controller, image-reflector-controller, kustomize-controller, notification-controller, source-controller, and source-watcher. Use when preparing a new controller patch release from a release series branch, drafting changelog entries, tagging releases, and opening the follow-up changelog PRs back to main.","long_description":"---\nname: flux-controller-patch-releases\ndescription: >\n Run the upstream Flux controller patch release procedure for helm-controller,\n image-automation-controller, image-reflector-controller, kustomize-controller,\n notification-controller, source-controller, and source-watcher. Use when\n preparing a new controller patch release from a release series branch,\n drafting changelog entries, tagging releases, and opening the follow-up\n changelog PRs back to main.\nlicense: Apache-2.0\n---\n\n# Flux Controller Patch Releases\n\nUse this skill for upstream Flux controller patch releases only. Do not use it\nfor `flux2`, `pkg`, or other non-controller repos.\n\nSupported controllers:\n- `helm-controller`\n- `image-automation-controller`\n- `image-reflector-controller`\n- `kustomize-controller`\n- `notification-controller`\n- `source-controller`\n- `source-watcher`\n\n## Important rules\n\n- **Go deep until you block, then switch.** Drive one controller all the way\n through every step you can do locally — branch, changelog commit, version\n bump commit, push, open PR — before switching to the next. Only move on\n when you hit something you cannot progress (CI running, PR awaiting review,\n tag workflow running). The moment something unblocks (PR merged, CI green,\n workflow finished), come back to it immediately — do not finish the current\n controller's local work first if an earlier one is ready to advance.\n- **Never block the conversation on long-running operations.** CI checks,\n release workflow runs, tag-triggered workflows, and similar waits must be\n watched in the background so the user can keep steering and so you can pick\n up any other controller the moment it unblocks. When a background watch\n completes, report the result and proceed.\n- **Always quote PR/issue links as full URLs** (e.g.\n `https://github.com/fluxcd/helm-controller/pull/1465`), never the\n `/#` shorthand — full URLs are clickable from the\n user's terminal, the shorthand is not.\n- **Start background watches on every PR immediately after opening it.** Kick\n off `gh pr checks -R fluxcd/ --watch` in the background as\n soon as the PR is created so CI status lands in the conversation the\n moment it finishes. Do the same for tag-triggered release workflows\n (`gh run watch -R fluxcd/` in the background). Do not wait\n until \"everything is pushed\" to start watching — start watching the first\n PR while you prepare the second.\n- **Also start a background approval watch per PR.** `gh pr checks --watch`\n only covers CI; it does not fire on maintainer approval. Poll the review\n state in the background so you are notified the moment it flips to\n APPROVED + CLEAN:\n ```\n while :; do\n state=$(gh pr view -R fluxcd/ --json mergeStateStatus,reviewDecision --jq '.reviewDecision+\" \"+.mergeStateStatus')\n case \"$state\" in \"APPROVED CLEAN\") echo \"$state\"; break;; esac\n sleep 30\n done\n ```\n Run this in the background; when it exits, merge the PR and proceed.\n- Every git commit must use `-s` (sign-off). Never include Co-Authored-By\n lines, your own name, or any AI attribution in commit messages, PR titles,\n or PR descriptions. This applies to all PRs, including PRs that update this\n skill file itself.\n- Always wait for CI to go green before merging any PR.\n- You cannot approve your own PRs. If a PR was opened by the git user driving\n the session, ask a maintainer to approve it (or confirm it is already\n approved) before merging.\n- **Merge release PRs yourself** (controller release PRs, changelog cherry-pick\n PRs) as soon as CI is green **and** a maintainer has approved. No need to\n ask the user to click merge — act on it immediately so the next step (tag\n push, etc.) unblocks. This applies only to PRs opened with the user's\n account during this session.\n- **Review feedback on release PRs is applied by amending**, not by adding\n new commits. A release PR must stay at exactly two commits\n (`Add changelog entry for vX.Y.Z` and `Release vX.Y.Z`). When the fix\n belongs in the changelog, amend the changelog commit; when it belongs in\n the release bump, amend that one. Use\n `git reset --soft HEAD~2` + re-commit, or an interactive rebase, then\n `git push --force-with-lease`.\n- **After applying a review fix, reply `Fixed, thanks!` on the thread and\n resolve it.** Reply via\n `gh api repos///pulls//comments//replies -f body='Fixed, thanks!'`\n and resolve via the GraphQL `resolveReviewThread` mutation. Find thread\n IDs with\n `gh api graphql -f query='{ repository(owner:\"\",name:\"\") { pullRequest(number:) { reviewThreads(first:50) { nodes { id isResolved comments(first:1){nodes{databaseId body}} } } } } }'`.\n- Do **not** watch CI on the skill-update PR continuously — it only needs to\n merge at the very end of the procedure, so check CI right before merging\n rather than keeping a watch open throughout the session.\n- Tags must be annotated and signed (`git tag -s -m ...`). Never create\n release tags through the GitHub API — that produces lightweight tags which\n break `git tag -v` verification.\n- Strictly follow the git commands documented in the release flow below. Do\n not invent substitutions or skip steps — each step has a reason.\n- **Do not declare a controller \"done\" until every step in the Release Flow\n below has been executed for it**, including the final changelog\n cherry-pick PR back to `main` (step 11) *and that PR being merged*. Merging\n the release PR and tagging is *not* the last step, and neither is opening\n the cherry-pick PR. Before reporting completion, walk through each\n controller against the numbered steps and confirm each one ran.\n- **Never halt while there is work you can do.** The session is over when\n every controller has been through all eleven steps and no PR opened during\n it is still waiting to be merged. Do not stop to report progress and wait\n for a prompt when nothing is blocking you — reporting is not a step, and\n \"the PRs are open\" is not a finish line. The only legitimate pauses are\n external: CI still running, a PR awaiting a maintainer's approval, a release\n workflow in flight. When one of those clears, act on it immediately instead\n of asking whether to continue.\n- PRs opened by this procedure use the commit subject as the PR title and an\n empty body.\n\n## Preconditions\n\n- Read the upstream procedure at `website/content/en/flux/releases/procedure.md`,\n section `Controllers: patch releases`.\n- Treat `git` and `gh` commands as confirmation points if the user wants that.\n- Use `date` to get the release date for changelog entries.\n- Fetch before reasoning about release branches or merged PRs. Do not trust stale\n local `origin/*` refs.\n\n## Release Flow\n\nFor each controller:\n\n1. Refresh local state.\n - `git fetch --all --tags --prune`\n - `git switch release/vX.Y.x`\n - `git pull origin release/vX.Y.x`\n\n2. Create the release preparation branch exactly from the release series branch.\n - `git switch -c release-vX.Y.Z release/vX.Y.x`\n\n3. Draft the new `CHANGELOG.md` entry.\n - Use the existing changelog structure in that repo.\n - Use the current date from `date`.\n - Build the entry from the commits merged into the release series branch since\n the previous tag.\n - Prefer PR titles over commit subjects for bullets.\n - Check the PRs that introduced the changes; do not infer titles from local\n commit messages.\n - For dependency-update PRs, inspect the PR body, any referenced upstream\n PRs, and the `go.mod` diff for notable content (see \"Dependency update\n PRs\" below) rather than settling for a generic bump line.\n - In the intro paragraph, summarize the concrete bug fixes shipped in the\n patch release.\n\n4. Commit the changelog entry.\n - `git add CHANGELOG.md`\n - `git commit -s -m \"Add changelog entry for vX.Y.Z\"`\n\n5. Apply the release version bump exactly as documented.\n - Update the controller self-API version in the root `go.mod`.\n - Update `config/manager/kustomization.yaml` `newTag` to `vX.Y.Z`.\n - Commit with:\n - `git add go.mod config/manager/kustomization.yaml`\n - `git commit -s -m \"Release vX.Y.Z\"`\n\n6. Push the release preparation branch.\n - `git push origin release-vX.Y.Z`\n\n7. Open and merge the release PR into the release series branch.\n - Base: `release/vX.Y.x`\n - Head: `release-vX.Y.Z`\n\n8. Refresh the release series branch after merge.\n - `git switch release/vX.Y.x`\n - `git pull origin release/vX.Y.x`\n\n9. Create and push signed tags from the updated release series branch.\n Push the `api/` tag first — the release tag depends on it.\n - `git tag -s -m \"api/vX.Y.Z\" api/vX.Y.Z`\n - `git push origin api/vX.Y.Z`\n - `git tag -s -m \"vX.Y.Z\" vX.Y.Z`\n - `git push origin vX.Y.Z`\n\n10. Confirm the non-`api/` tag triggered the release workflow.\n\n11. Cherry-pick only the changelog commit back to `main`.\n - `git switch main`\n - `git pull origin main`\n - `git switch -c pick-changelog-vX.Y.Z main`\n - `git cherry-pick -x `\n - `git push origin pick-changelog-vX.Y.Z`\n - Open PR from `pick-changelog-vX.Y.Z` to `main`\n - Do this one controller at a time — never chain several controllers'\n cherry-picks into a single shell invocation. If such a batch is\n interrupted partway, the branches it already created make a later\n `git switch -c` fail, which silently leaves you on `main`, so the next\n `git cherry-pick` lands the changelog commit on local `main` instead of\n the pick branch. Before cherry-picking, confirm you are on\n `pick-changelog-vX.Y.Z`; if the branch already exists, switch to it (or\n delete and recreate it) rather than letting `switch -c` fail.\n\n## How To Build The Changelog Entry\n\nFor a patch release, gather:\n- the latest release tag on the release line\n- the merged commits on `origin/release/vX.Y.x` since that tag\n- the PRs corresponding to those merges\n\nWrite the new section at the top of `CHANGELOG.md`:\n- `## X.Y.Z`\n- `**Release date:** YYYY-MM-DD`\n- short intro paragraph describing the actual bug fixes in user-facing language\n- `Fixes:` when there are bug-fix items\n- `Improvements:` for dependency updates, docs, feature gates, or cleanup\n\nRules:\n- Use PR titles, not raw commit messages\n- Group multiple dependency bump PRs naturally when the repo history already does that\n- Verify the title against GitHub when the local merge commit is vague\n\n### Dependency update PRs\n\nDo not reduce a dependency bump to a generic \"Update fluxcd/pkg dependencies\"\nline and move on — the user-facing substance is usually hidden inside the bump.\nWeigh Flux's own repos and third-party dependencies differently:\n\n- **The `fluxcd/*` modules are what matter.** These are our own libraries, so a\n bump is how a fix we made reaches the controller. Trace every module in the\n `go.mod` diff back to its commits, e.g. in a local clone of `fluxcd/pkg`:\n `git log --oneline --no-merges /../ -- `, filtering\n out `Prepare for release` and the shared `Upgrade k8s to ...` commits. Read\n the PR behind each remaining commit and describe the fix in the controller's\n own terms. Doing this across all the modules of one release usually leaves a\n handful of real changes, which is a short enough list to reason about\n per controller.\n- **Third-party bumps are noise unless they fix something our users hit.** Do\n not recount an upstream project's release notes, and do not list upstream\n CVE/GHSA advisories that merely rode along with a bump. Mention an upstream\n change only when it resolves an issue reported by Flux users, or when the\n upgrade itself is the point (e.g. syncing the Helm version with the one\n helm-controller ships) — and then say why it matters to Flux, not what\n changed upstream.\n- **State the Kubernetes bump when `k8s.io/*` actually moves**, e.g. \"which\n bring Kubernetes to 1.36.4\". Read the version off the `go.mod` diff for that\n specific bu","tagline":"Run the upstream Flux controller patch release procedure for helm-controller, image-automation-controller, image-reflector-controller, kustomize-controller, notification-controller, source-controller, and source-watcher. Use when preparing a new controller patch release from a re","category":"research","tags":["agent-skill"],"author":"fluxcd","verified":false,"attribution":{"status":"registry_indexed","statusLabel":"Registry indexed","shortLabel":"REGISTRY INDEXED","sourceLabel":"github fast track","sourceDetail":"fluxcd/agent-skills","creatorName":"fluxcd","creatorUrl":"https://github.com/fluxcd","sourceUrl":"https://github.com/fluxcd/agent-skills/tree/main/internal/skills/flux-controller-patch-releases","indexedBy":"OpenAgentSkill community index","claimUrl":"https://www.openagentskill.com/skills/fluxcd-flux-controller-patch-releases#claim-this-skill","claimCta":"Claim this skill","trustNote":"This listing was indexed from public sources and is not marked official until a maintainer claim is approved.","publicNote":"Attribution links to the public repository or creator profile. Creators can claim the listing to update ownership signals."},"stats":{"stars":217,"forks":9,"verified_installs":0,"successful_runs":0,"total_outcomes":0,"rating":0,"review_count":0,"quality_score":39.47},"quality":{"score":70,"tier":"strong","label":"Strong","summary":"Solid option that is likely worth shortlisting for production workflows.","signals":[{"label":"GitHub stars","value":"217","tone":"neutral"},{"label":"Freshness","value":"5d ago","tone":"positive"},{"label":"Install ready","value":"Yes","tone":"positive"},{"label":"License","value":"Apache-2.0","tone":"neutral"}],"warnings":[]},"trust":{"version":"trust-score-v5","score":67,"base_score":75,"outcome_confidence":0,"tier":"review","label":"Sandbox only","summary":"Useful candidate with missing or mixed trust signals. Keep it in an isolated workspace until the outcome loop proves task fit.","recommendedAction":"Run only in a sandbox and compare close alternatives before using it for real work.","decision":{"install_policy":"human_review_before_install","auto_install_allowed":false,"human_review_required":true,"sandbox_first":true,"agent_action":"Compare alternatives before installing.","reasoning":["67/100 Trust Score v5","75/100 Trust Score v4 baseline","Needs more real agent outcomes before unattended install","Install path is available","Review before production"],"review_required_when":["The workspace contains production secrets, payments, private customer data, or irreversible actions.","The install command requests shell, network, credential, database, or broad filesystem access.","Outcome evidence is missing, recently failed, or required human review.","Production credentials, payments, or irreversible account changes without explicit human review","Sensitive private data before reviewing repository code, license, and permission surface","Automatic installation in a production workspace"]},"dimensions":[{"id":"github_adoption","label":"GitHub adoption","score":62,"weight":0.13,"status":"info","detail":"217 GitHub stars"},{"id":"repo_activity","label":"Stars/forks activity","score":51,"weight":0.08,"status":"warn","detail":"217 stars, 9 forks; issue activity unavailable in current metadata"},{"id":"maintenance","label":"Recent maintenance","score":100,"weight":0.14,"status":"pass","detail":"5d since push"},{"id":"license","label":"License clarity","score":86,"weight":0.09,"status":"pass","detail":"Apache-2.0"},{"id":"documentation","label":"README/SKILL.md completeness","score":76,"weight":0.14,"status":"info","detail":"Public metadata needs stronger README/SKILL.md context"},{"id":"dependency_risk","label":"Dependency/runtime risk","score":64,"weight":0.12,"status":"info","detail":"command execution surface, network or browser surface"},{"id":"installability","label":"Install availability","score":92,"weight":0.1,"status":"pass","detail":"npx skills add fluxcd/agent-skills --skill flux-controller-patch-releases"},{"id":"install_safety","label":"Install command safety","score":92,"weight":0.1,"status":"pass","detail":"standard package or runtime install path"},{"id":"permission_surface","label":"Permission surface","score":48,"weight":0.07,"status":"warn","detail":"shell or command execution, filesystem or document access"},{"id":"repository","label":"Repository evidence","score":86,"weight":0.04,"status":"pass","detail":"https://github.com/fluxcd/agent-skills/tree/main/internal/skills/flux-controller-patch-releases"},{"id":"review_status","label":"Review status","score":88,"weight":0.05,"status":"pass","detail":"AI review data available"},{"id":"agent_outcomes","label":"Agent Proven outcomes","score":54,"weight":0.13,"status":"info","detail":"No agent outcome data yet"}],"checks":[{"status":"info","label":"GitHub adoption","detail":"217 GitHub stars"},{"status":"warn","label":"Stars/forks activity","detail":"217 stars, 9 forks; issue activity unavailable in current metadata"},{"status":"pass","label":"Recent maintenance","detail":"5d since push"},{"status":"pass","label":"License clarity","detail":"Apache-2.0"},{"status":"info","label":"README/SKILL.md completeness","detail":"Public metadata needs stronger README/SKILL.md context"},{"status":"info","label":"Dependency/runtime risk","detail":"command execution surface, network or browser surface"},{"status":"pass","label":"Install availability","detail":"npx skills add fluxcd/agent-skills --skill flux-controller-patch-releases"},{"status":"pass","label":"Install command safety","detail":"standard package or runtime install path"},{"status":"warn","label":"Permission surface","detail":"shell or command execution, filesystem or document access"},{"status":"pass","label":"Repository evidence","detail":"https://github.com/fluxcd/agent-skills/tree/main/internal/skills/flux-controller-patch-releases"},{"status":"pass","label":"Review status","detail":"AI review data available"},{"status":"info","label":"Agent Proven outcomes","detail":"No agent outcome data yet"},{"status":"warn","label":"Ownership","detail":"No approved owner claim yet"},{"status":"info","label":"OpenAgentSkill usage","detail":"No local usage activity yet"},{"status":"info","label":"Agent outcomes","detail":"No agent outcome data yet"}],"strengths":["AI review approved","Install path is available","Repository evidence is available","Recently maintained repository","Install command has no obvious high-risk pattern","Outcome loop is ready but needs first real agent run"],"warnings":["Quality score needs review","Permission surface needs review: shell or command execution, filesystem or document access","Stars/forks activity: 217 stars, 9 forks; issue activity unavailable in current metadata","Permission surface: shell or command execution, filesystem or document access","No real agent outcome reports yet","Human review required before unattended installation"],"evidence":{"stars":"217 GitHub stars","repoActivity":"217 stars, 9 forks","lastPushed":"5d since push","license":"Apache-2.0","repository":"https://github.com/fluxcd/agent-skills/tree/main/internal/skills/flux-controller-patch-releases","install":"npx skills add fluxcd/agent-skills --skill flux-controller-patch-releases","installSafety":"standard package or runtime install path","permissionSurface":"shell or command execution, filesystem or document access","documentation":"Usable metadata, review docs","agentOutcomes":"No agent outcome data yet","agentProvenScore":0,"outcomeConfidence":"0%","installPolicy":"human_review_before_install"},"installReadiness":{"ready":true,"command":"npx skills add fluxcd/agent-skills --skill flux-controller-patch-releases","policy":"human_review_before_install","label":"Human review before install","notes":["Install path is available","Repository evidence is available","License is declared","No Agent Proven outcome evidence yet","5d since push","Trust Score v5 requires review or sandbox-only use before install."]},"agentCompatibility":["Codex","Claude Code","Cursor","OpenAgentSkill CLI"],"riskSummary":{"level":"medium","label":"Review before production","notes":["Quality score needs review","Permission surface needs review: shell or command execution, filesystem or document access","Stars/forks activity: 217 stars, 9 forks; issue activity unavailable in current metadata","Permission surface: shell or command execution, filesystem or document access"]},"outcomeEvidence":{"total":0,"successes":0,"failures":0,"notRelevant":0,"successRate":null,"installAttempts":0,"riskBlocked":0,"setupRequired":0,"installSuccessRate":null,"avgOutputQuality":null,"avgTimeToUsefulMs":null,"productionOutcomes":0,"humanReviewRequired":0,"recentSuccessRate":null,"recentFailureRate":null,"uniqueAgents":0,"agentProvenScore":0,"agentProvenLabel":"Needs first agent run","lastOutcomeAt":null,"label":"No agent outcome data yet"},"autoInstall":{"allowed":false,"sandboxRequired":true,"policy":"human_review_before_install","reason":"Compare alternatives before installing."},"outcome_loop":{"version":"openagentskill-agent-outcome-v4","required_after_install":true,"endpoint":"/api/agent/outcome","method":"POST","event_id_source":"feedback.event_id, install_receipt.resolve_event_id, or decision_packet.outcome_feedback.event_id","expected_outcomes":["success","failed","not_relevant","blocked_by_risk","setup_required"],"required_fields":["event_id","skill_slug","task"],"quality_fields":["task_success","output_quality","error_type","human_review_required","used_in_production","workspace","evidence_url","time_to_useful_ms","source_version"],"ranking_inputs_updated":["Trust Score v5 outcome confidence","Agent Proven Score","Resolve ranking task-fit evidence","Skill detail machine-readable metadata","Outcome leaderboard"]},"agent_contract":{"suited_tasks":["research","agent-skill"],"suited_agents":["Codex","Claude Code","Cursor","OpenAgentSkill CLI"],"install_command":"npx skills add fluxcd/agent-skills --skill flux-controller-patch-releases","trust_score":67,"trust_version":"trust-score-v5","risk_level":"medium","do_not_use_when":["Production credentials, payments, or irreversible account changes without explicit human review","Sensitive private data before reviewing repository code, license, and permission surface","Automatic installation in a production workspace"],"before_install":["Read the audit page and machine-readable metadata.","Confirm the install command, license, and permission surface fit the workspace.","Get explicit human approval or choose an alternative before installing."],"after_run":["Report the outcome to /api/agent/outcome using the resolve event id.","Include output_quality, workspace, human_review_required, and evidence_url when available.","Re-resolve before broad production rollout."]},"bestFor":["research","agent-skill"],"doNotUseFor":["Production credentials, payments, or irreversible account changes without explicit human review","Sensitive private data before reviewing repository code, license, and permission surface","Automatic installation in a production workspace"],"knownRisks":["Quality score needs review","Permission surface needs review: shell or command execution, filesystem or document access","Stars/forks activity: 217 stars, 9 forks; issue activity unavailable in current metadata","Permission surface: shell or command execution, filesystem or document access"],"backward_compatible":{"trust_score_v4":{"version":"trust-score-v4","score":75,"tier":"strong","label":"Strong shortlist","summary":"Good trust signals with a few areas worth checking before rollout."}}},"trust_score_v5":{"version":"trust-score-v5","score":67,"base_score":75,"outcome_confidence":0,"tier":"review","label":"Sandbox only","summary":"Useful candidate with missing or mixed trust signals. Keep it in an isolated workspace until the outcome loop proves task fit.","recommendedAction":"Run only in a sandbox and compare close alternatives before using it for real work.","decision":{"install_policy":"human_review_before_install","auto_install_allowed":false,"human_review_required":true,"sandbox_first":true,"agent_action":"Compare alternatives before installing.","reasoning":["67/100 Trust Score v5","75/100 Trust Score v4 baseline","Needs more real agent outcomes before unattended install","Install path is available","Review before production"],"review_required_when":["The workspace contains production secrets, payments, private customer data, or irreversible actions.","The install command requests shell, network, credential, database, or broad filesystem access.","Outcome evidence is missing, recently failed, or required human review.","Production credentials, payments, or irreversible account changes without explicit human review","Sensitive private data before reviewing repository code, license, and permission surface","Automatic installation in a production workspace"]},"dimensions":[{"id":"github_adoption","label":"GitHub adoption","score":62,"weight":0.13,"status":"info","detail":"217 GitHub stars"},{"id":"repo_activity","label":"Stars/forks activity","score":51,"weight":0.08,"status":"warn","detail":"217 stars, 9 forks; issue activity unavailable in current metadata"},{"id":"maintenance","label":"Recent maintenance","score":100,"weight":0.14,"status":"pass","detail":"5d since push"},{"id":"license","label":"License clarity","score":86,"weight":0.09,"status":"pass","detail":"Apache-2.0"},{"id":"documentation","label":"README/SKILL.md completeness","score":76,"weight":0.14,"status":"info","detail":"Public metadata needs stronger README/SKILL.md context"},{"id":"dependency_risk","label":"Dependency/runtime risk","score":64,"weight":0.12,"status":"info","detail":"command execution surface, network or browser surface"},{"id":"installability","label":"Install availability","score":92,"weight":0.1,"status":"pass","detail":"npx skills add fluxcd/agent-skills --skill flux-controller-patch-releases"},{"id":"install_safety","label":"Install command safety","score":92,"weight":0.1,"status":"pass","detail":"standard package or runtime install path"},{"id":"permission_surface","label":"Permission surface","score":48,"weight":0.07,"status":"warn","detail":"shell or command execution, filesystem or document access"},{"id":"repository","label":"Repository evidence","score":86,"weight":0.04,"status":"pass","detail":"https://github.com/fluxcd/agent-skills/tree/main/internal/skills/flux-controller-patch-releases"},{"id":"review_status","label":"Review status","score":88,"weight":0.05,"status":"pass","detail":"AI review data available"},{"id":"agent_outcomes","label":"Agent Proven outcomes","score":54,"weight":0.13,"status":"info","detail":"No agent outcome data yet"}],"checks":[{"status":"info","label":"GitHub adoption","detail":"217 GitHub stars"},{"status":"warn","label":"Stars/forks activity","detail":"217 stars, 9 forks; issue activity unavailable in current metadata"},{"status":"pass","label":"Recent maintenance","detail":"5d since push"},{"status":"pass","label":"License clarity","detail":"Apache-2.0"},{"status":"info","label":"README/SKILL.md completeness","detail":"Public metadata needs stronger README/SKILL.md context"},{"status":"info","label":"Dependency/runtime risk","detail":"command execution surface, network or browser surface"},{"status":"pass","label":"Install availability","detail":"npx skills add fluxcd/agent-skills --skill flux-controller-patch-releases"},{"status":"pass","label":"Install command safety","detail":"standard package or runtime install path"},{"status":"warn","label":"Permission surface","detail":"shell or command execution, filesystem or document access"},{"status":"pass","label":"Repository evidence","detail":"https://github.com/fluxcd/agent-skills/tree/main/internal/skills/flux-controller-patch-releases"},{"status":"pass","label":"Review status","detail":"AI review data available"},{"status":"info","label":"Agent Proven outcomes","detail":"No agent outcome data yet"},{"status":"warn","label":"Ownership","detail":"No approved owner claim yet"},{"status":"info","label":"OpenAgentSkill usage","detail":"No local usage activity yet"},{"status":"info","label":"Agent outcomes","detail":"No agent outcome data yet"}],"strengths":["AI review approved","Install path is available","Repository evidence is available","Recently maintained repository","Install command has no obvious high-risk pattern","Outcome loop is ready but needs first real agent run"],"warnings":["Quality score needs review","Permission surface needs review: shell or command execution, filesystem or document access","Stars/forks activity: 217 stars, 9 forks; issue activity unavailable in current metadata","Permission surface: shell or command execution, filesystem or document access","No real agent outcome reports yet","Human review required before unattended installation"],"evidence":{"stars":"217 GitHub stars","repoActivity":"217 stars, 9 forks","lastPushed":"5d since push","license":"Apache-2.0","repository":"https://github.com/fluxcd/agent-skills/tree/main/internal/skills/flux-controller-patch-releases","install":"npx skills add fluxcd/agent-skills --skill flux-controller-patch-releases","installSafety":"standard package or runtime install path","permissionSurface":"shell or command execution, filesystem or document access","documentation":"Usable metadata, review docs","agentOutcomes":"No agent outcome data yet","agentProvenScore":0,"outcomeConfidence":"0%","installPolicy":"human_review_before_install"},"installReadiness":{"ready":true,"command":"npx skills add fluxcd/agent-skills --skill flux-controller-patch-releases","policy":"human_review_before_install","label":"Human review before install","notes":["Install path is available","Repository evidence is available","License is declared","No Agent Proven outcome evidence yet","5d since push","Trust Score v5 requires review or sandbox-only use before install."]},"agentCompatibility":["Codex","Claude Code","Cursor","OpenAgentSkill CLI"],"riskSummary":{"level":"medium","label":"Review before production","notes":["Quality score needs review","Permission surface needs review: shell or command execution, filesystem or document access","Stars/forks activity: 217 stars, 9 forks; issue activity unavailable in current metadata","Permission surface: shell or command execution, filesystem or document access"]},"outcomeEvidence":{"total":0,"successes":0,"failures":0,"notRelevant":0,"successRate":null,"installAttempts":0,"riskBlocked":0,"setupRequired":0,"installSuccessRate":null,"avgOutputQuality":null,"avgTimeToUsefulMs":null,"productionOutcomes":0,"humanReviewRequired":0,"recentSuccessRate":null,"recentFailureRate":null,"uniqueAgents":0,"agentProvenScore":0,"agentProvenLabel":"Needs first agent run","lastOutcomeAt":null,"label":"No agent outcome data yet"},"autoInstall":{"allowed":false,"sandboxRequired":true,"policy":"human_review_before_install","reason":"Compare alternatives before installing."},"outcome_loop":{"version":"openagentskill-agent-outcome-v4","required_after_install":true,"endpoint":"/api/agent/outcome","method":"POST","event_id_source":"feedback.event_id, install_receipt.resolve_event_id, or decision_packet.outcome_feedback.event_id","expected_outcomes":["success","failed","not_relevant","blocked_by_risk","setup_required"],"required_fields":["event_id","skill_slug","task"],"quality_fields":["task_success","output_quality","error_type","human_review_required","used_in_production","workspace","evidence_url","time_to_useful_ms","source_version"],"ranking_inputs_updated":["Trust Score v5 outcome confidence","Agent Proven Score","Resolve ranking task-fit evidence","Skill detail machine-readable metadata","Outcome leaderboard"]},"agent_contract":{"suited_tasks":["research","agent-skill"],"suited_agents":["Codex","Claude Code","Cursor","OpenAgentSkill CLI"],"install_command":"npx skills add fluxcd/agent-skills --skill flux-controller-patch-releases","trust_score":67,"trust_version":"trust-score-v5","risk_level":"medium","do_not_use_when":["Production credentials, payments, or irreversible account changes without explicit human review","Sensitive private data before reviewing repository code, license, and permission surface","Automatic installation in a production workspace"],"before_install":["Read the audit page and machine-readable metadata.","Confirm the install command, license, and permission surface fit the workspace.","Get explicit human approval or choose an alternative before installing."],"after_run":["Report the outcome to /api/agent/outcome using the resolve event id.","Include output_quality, workspace, human_review_required, and evidence_url when available.","Re-resolve before broad production rollout."]},"bestFor":["research","agent-skill"],"doNotUseFor":["Production credentials, payments, or irreversible account changes without explicit human review","Sensitive private data before reviewing repository code, license, and permission surface","Automatic installation in a production workspace"],"knownRisks":["Quality score needs review","Permission surface needs review: shell or command execution, filesystem or document access","Stars/forks activity: 217 stars, 9 forks; issue activity unavailable in current metadata","Permission surface: shell or command execution, filesystem or document access"],"backward_compatible":{"trust_score_v4":{"version":"trust-score-v4","score":75,"tier":"strong","label":"Strong shortlist","summary":"Good trust signals with a few areas worth checking before rollout."}}},"trust_score_v4":{"version":"trust-score-v4","score":75,"tier":"strong","label":"Strong shortlist","summary":"Good trust signals with a few areas worth checking before rollout.","recommendedAction":"Test in a sandbox workflow and compare its install path with close alternatives.","dimensions":[{"id":"github_adoption","label":"GitHub adoption","score":62,"weight":0.13,"status":"info","detail":"217 GitHub stars"},{"id":"repo_activity","label":"Stars/forks activity","score":51,"weight":0.08,"status":"warn","detail":"217 stars, 9 forks; issue activity unavailable in current metadata"},{"id":"maintenance","label":"Recent maintenance","score":100,"weight":0.14,"status":"pass","detail":"5d since push"},{"id":"license","label":"License clarity","score":86,"weight":0.09,"status":"pass","detail":"Apache-2.0"},{"id":"documentation","label":"README/SKILL.md completeness","score":76,"weight":0.14,"status":"info","detail":"Public metadata needs stronger README/SKILL.md context"},{"id":"dependency_risk","label":"Dependency/runtime risk","score":64,"weight":0.12,"status":"info","detail":"command execution surface, network or browser surface"},{"id":"installability","label":"Install availability","score":92,"weight":0.1,"status":"pass","detail":"npx skills add fluxcd/agent-skills --skill flux-controller-patch-releases"},{"id":"install_safety","label":"Install command safety","score":92,"weight":0.1,"status":"pass","detail":"standard package or runtime install path"},{"id":"permission_surface","label":"Permission surface","score":48,"weight":0.07,"status":"warn","detail":"shell or command execution, filesystem or document access"},{"id":"repository","label":"Repository evidence","score":86,"weight":0.04,"status":"pass","detail":"https://github.com/fluxcd/agent-skills/tree/main/internal/skills/flux-controller-patch-releases"},{"id":"review_status","label":"Review status","score":88,"weight":0.05,"status":"pass","detail":"AI review data available"},{"id":"agent_outcomes","label":"Agent Proven outcomes","score":54,"weight":0.13,"status":"info","detail":"No agent outcome data yet"}],"checks":[{"status":"info","label":"GitHub adoption","detail":"217 GitHub stars"},{"status":"warn","label":"Stars/forks activity","detail":"217 stars, 9 forks; issue activity unavailable in current metadata"},{"status":"pass","label":"Recent maintenance","detail":"5d since push"},{"status":"pass","label":"License clarity","detail":"Apache-2.0"},{"status":"info","label":"README/SKILL.md completeness","detail":"Public metadata needs stronger README/SKILL.md context"},{"status":"info","label":"Dependency/runtime risk","detail":"command execution surface, network or browser surface"},{"status":"pass","label":"Install availability","detail":"npx skills add fluxcd/agent-skills --skill flux-controller-patch-releases"},{"status":"pass","label":"Install command safety","detail":"standard package or runtime install path"},{"status":"warn","label":"Permission surface","detail":"shell or command execution, filesystem or document access"},{"status":"pass","label":"Repository evidence","detail":"https://github.com/fluxcd/agent-skills/tree/main/internal/skills/flux-controller-patch-releases"},{"status":"pass","label":"Review status","detail":"AI review data available"},{"status":"info","label":"Agent Proven outcomes","detail":"No agent outcome data yet"},{"status":"warn","label":"Ownership","detail":"No approved owner claim yet"},{"status":"info","label":"OpenAgentSkill usage","detail":"No local usage activity yet"},{"status":"info","label":"Agent outcomes","detail":"No agent outcome data yet"}],"strengths":["AI review approved","Install path is available","Repository evidence is available","Recently maintained repository","Install command has no obvious high-risk pattern"],"warnings":["Quality score needs review","Permission surface needs review: shell or command execution, filesystem or document access","Stars/forks activity: 217 stars, 9 forks; issue activity unavailable in current metadata","Permission surface: shell or command execution, filesystem or document access"],"evidence":{"stars":"217 GitHub stars","repoActivity":"217 stars, 9 forks","lastPushed":"5d since push","license":"Apache-2.0","repository":"https://github.com/fluxcd/agent-skills/tree/main/internal/skills/flux-controller-patch-releases","install":"npx skills add fluxcd/agent-skills --skill flux-controller-patch-releases","installSafety":"standard package or runtime install path","permissionSurface":"shell or command execution, filesystem or document access","documentation":"Usable metadata, review docs","agentOutcomes":"No agent outcome data yet"},"installReadiness":{"ready":true,"command":"npx skills add fluxcd/agent-skills --skill flux-controller-patch-releases","policy":"human_review_before_install","label":"Human review before install","notes":["Install path is available","Repository evidence is available","License is declared","No Agent Proven outcome evidence yet","5d since push"]},"agentCompatibility":["Codex","Claude Code","Cursor","OpenAgentSkill CLI"],"riskSummary":{"level":"medium","label":"Review before production","notes":["Quality score needs review","Permission surface needs review: shell or command execution, filesystem or document access","Stars/forks activity: 217 stars, 9 forks; issue activity unavailable in current metadata","Permission surface: shell or command execution, filesystem or document access"]},"outcomeEvidence":{"total":0,"successes":0,"failures":0,"notRelevant":0,"successRate":null,"installAttempts":0,"riskBlocked":0,"setupRequired":0,"installSuccessRate":null,"avgOutputQuality":null,"avgTimeToUsefulMs":null,"productionOutcomes":0,"humanReviewRequired":0,"recentSuccessRate":null,"recentFailureRate":null,"uniqueAgents":0,"agentProvenScore":0,"agentProvenLabel":"Needs first agent run","lastOutcomeAt":null,"label":"No agent outcome data yet"},"autoInstall":{"allowed":false,"sandboxRequired":true,"policy":"human_review_before_install","reason":"Human review or sandbox validation is required before automatic installation."},"bestFor":["research","agent-skill"],"doNotUseFor":["Production credentials, payments, or irreversible account changes without explicit human review","Sensitive private data before reviewing repository code, license, and permission surface","Automatic installation in a production workspace"],"knownRisks":["Quality score needs review","Permission surface needs review: shell or command execution, filesystem or document access","Stars/forks activity: 217 stars, 9 forks; issue activity unavailable in current metadata","Permission surface: shell or command execution, filesystem or document access"]},"agent_proven":{"version":"agent-proven-v1","score":0,"tier":"unproven","label":"Needs first agent run","summary":"No agent outcome reports yet. Use Resolve, run one narrow sandbox task, then report the result.","metrics":{"totalOutcomes":0,"successfulOutcomes":0,"failedOutcomes":0,"installAttempts":0,"installSuccessRate":null,"successRate":null,"recentSuccessRate":null,"recentFailureRate":null,"riskBlocked":0,"setupRequired":0,"notRelevant":0,"avgOutputQuality":null,"avgTimeToUsefulMs":null,"productionOutcomes":0,"humanReviewRequired":0,"uniqueAgents":0,"lastOutcomeAt":null},"signals":[],"penalties":["No real agent outcome evidence yet"]},"outcome_stats":null,"safety":{"score":48,"level":"avoid_auto_install","label":"Avoid automatic install","safety_tier":{"tier":"experimental","label":"Experimental","badge":"EXPERIMENTAL","summary":"Sparse or mixed signals. Useful for discovery, but not for autonomous installation.","recommended_action":"Test manually in an isolated workspace and compare against safer alternatives.","auto_install_policy":"review","reasons":["High-risk permission hints: Shell or command execution","48/100 agent safety score"]},"auto_install_allowed":false,"human_review_required":true,"blocked":false,"audit_risk":"needs_review","permission_hints":[{"id":"shell","label":"Shell or command execution","reason":"Skill metadata references terminal, CLI, shell, subprocess, or command execution workflows.","severity":"high"},{"id":"network","label":"Network access","reason":"Skill likely fetches remote pages, APIs, repositories, or external services.","severity":"medium"},{"id":"filesystem","label":"Filesystem access","reason":"Skill may read or write project files, documents, generated artifacts, or local workspace state.","severity":"medium"},{"id":"database","label":"Database access","reason":"Skill may inspect schemas, query databases, or work with persistent stores.","severity":"medium"}],"policy_warnings":["High-risk permission hints: Shell or command execution","Permission surface may require sandboxing"],"constraints_applied":{"max_risk":"medium","needs_install_command":true,"min_stars":0}},"safety_gate":{"tier":"experimental","label":"Experimental","badge":"EXPERIMENTAL","auto_install_policy":"review","auto_install_allowed":false,"blocked":false,"human_review_required":true,"recommended_action":"Test manually in an isolated workspace and compare against safer alternatives.","reasons":["High-risk permission hints: Shell or command execution","48/100 agent safety score"]},"eval":{"version":"openagentskill-skill-eval-v1","status":"failed","score":71,"risk_level":"high","decision":{"recommendation":"do_not_auto_install","reason":"Permission surface: shell or command execution, filesystem or document access","auto_install_allowed":false,"policy":"block","human_review_required":true},"blockers":["Permission surface: shell or command execution, filesystem or document access"],"warnings":["Trust score: Good trust signals with a few areas worth checking before rollout.","Audit score: Needs review","Agent safety gate: Sparse or mixed signals. Useful for discovery, but not for autonomous installation.","README/SKILL.md completeness: Public metadata needs stronger README/SKILL.md context","High-risk permission hints: Shell or command execution","Permission surface may require sandboxing","Quality score needs review","Permission surface needs review: shell or command execution, filesystem or document access","Stars/forks activity: 217 stars, 9 forks; issue activity unavailable in current metadata","Permission surface: shell or command execution, filesystem or document access"],"validation_plan":["Inspect repository, README/SKILL.md, license, and recent commits before production use.","Install in an isolated workspace or sandbox with no production secrets available.","Run the smallest representative task and record files touched, commands run, network access, and outputs.","Compare the selected skill against at least one alternative when the eval status is review or failed.","Promote only after the agent reports a successful verification result and unresolved warnings are accepted."],"checks":[{"id":"task_fit","label":"Task fit","status":"pass","score":94,"required_for_auto_install":true,"detail":"Task wording matches this skill metadata.","evidence":["Evaluate flux-controller-patch-releases before installing it in an agent workflow","research","GitHub automation workflows; Claude Code teams; builders willing to evaluate younger projects"]},{"id":"install_path","label":"Install path","status":"pass","score":92,"required_for_auto_install":true,"detail":"Install handoff is available.","evidence":["npx skills add fluxcd/agent-skills --skill flux-controller-patch-releases"]},{"id":"install_safety","label":"Install command safety","status":"pass","score":92,"required_for_auto_install":true,"detail":"standard package or runtime install path","evidence":["npx skills add fluxcd/agent-skills --skill flux-controller-patch-releases"]},{"id":"trust_score","label":"Trust score","status":"warn","score":75,"required_for_auto_install":true,"detail":"Good trust signals with a few areas worth checking before rollout.","evidence":["Strong shortlist","217 GitHub stars","Apache-2.0"]},{"id":"audit_score","label":"Audit score","status":"warn","score":80,"required_for_auto_install":true,"detail":"Needs review","evidence":["Permission surface may require sandboxing"]},{"id":"agent_safety_gate","label":"Agent safety gate","status":"warn","score":48,"required_for_auto_install":true,"detail":"Sparse or mixed signals. Useful for discovery, but not for autonomous installation.","evidence":["Test manually in an isolated workspace and compare against safer alternatives.","High-risk permission hints: Shell or command execution"]},{"id":"readme_skillmd_completeness","label":"README/SKILL.md completeness","status":"warn","score":76,"required_for_auto_install":false,"detail":"Public metadata needs stronger README/SKILL.md context","evidence":["Usable metadata, review docs"]},{"id":"license_clarity","label":"License clarity","status":"pass","score":86,"required_for_auto_install":true,"detail":"Apache-2.0","evidence":["Apache-2.0"]},{"id":"recent_maintenance","label":"Recent maintenance","status":"pass","score":100,"required_for_auto_install":false,"detail":"5d since push","evidence":["5d since push"]},{"id":"permission_surface","label":"Permission surface","status":"fail","score":48,"required_for_auto_install":true,"detail":"shell or command execution, filesystem or document access","evidence":["Shell or command execution: high","Network access: medium","Filesystem access: medium"]},{"id":"alternatives","label":"Alternatives available","status":"info","score":55,"required_for_auto_install":false,"detail":"No close alternatives were found in the current shortlist.","evidence":[]}],"endpoints":{"web":"https://www.openagentskill.com/skills/fluxcd-flux-controller-patch-releases/evals","api":"/api/agent/evals?slug=fluxcd-flux-controller-patch-releases","text":"/api/agent/evals?slug=fluxcd-flux-controller-patch-releases&format=text"}},"agent_readable_metadata":{"version":"openagentskill-agent-metadata-v2","skill":{"slug":"fluxcd-flux-controller-patch-releases","name":"flux-controller-patch-releases","description":"Run the upstream Flux controller patch release procedure for helm-controller, image-automation-controller, image-reflector-controller, kustomize-controller, notification-controller, source-controller, and source-watcher. Use when preparing a new controller patch release from a release series branch, drafting changelog entries, tagging releases, and opening the follow-up changelog PRs back to main.","category":"research","url":"https://www.openagentskill.com/skills/fluxcd-flux-controller-patch-releases","repository":"https://github.com/fluxcd/agent-skills/tree/main/internal/skills/flux-controller-patch-releases","github_repo":"fluxcd/agent-skills"},"suited_tasks":["GitHub automation workflows","Claude Code teams","builders willing to evaluate younger projects","Inspect repository metadata","Compare code changes","Write concise engineering summaries","Search sources","Extract claims"],"suited_agents":["Codex","Claude Code","Cursor","OpenAgentSkill CLI","CLI"],"install":{"command":"npx skills add fluxcd/agent-skills --skill flux-controller-patch-releases","ready":true,"targets":[{"id":"openagentskill-cli","label":"CLI","kind":"command","value":"npx --yes https://github.com/Leon-Drq/openagentskill/releases/download/cli-v0.3.0/openagentskill-0.3.0.tgz add fluxcd-flux-controller-patch-releases"},{"id":"codex","label":"Codex","kind":"agent-prompt","value":"Install the \"flux-controller-patch-releases\" agent skill from https://github.com/fluxcd/agent-skills/tree/main/internal/skills/flux-controller-patch-releases. Read its SKILL.md or equivalent instructions first, install only the files needed for this workspace, and summarize any required setup before using it. Skill purpose: Run the upstream Flux controller patch release procedure for helm-controller, image-automation-controller, image-reflector-controller, kustomize-controller, notification-controller, source-controller, and source-watcher. Use when preparing a new controller patch release from a release series branch, drafting changelog entries, tagging releases, and opening the follow-up changelog PRs back to main. After the install attempt, report the result to https://www.openagentskill.com/api/agent/outcome with POST JSON {\"event_id\":\"install_\",\"skill_slug\":\"fluxcd-flux-controller-patch-releases\",\"task\":\"Install flux-controller-patch-releases\",\"agent\":\"codex\",\"outcome\":\"success\",\"install_used\":true}. Replace event_id with a unique value and outcome with success or failed. Report success only after the skill is installed and a minimal verification passes."},{"id":"claude-code","label":"Claude Code","kind":"agent-prompt","value":"Add \"flux-controller-patch-releases\" as a Claude Code skill from https://github.com/fluxcd/agent-skills/tree/main/internal/skills/flux-controller-patch-releases. Inspect the skill instructions, place the reusable skill files in the appropriate local skills location for this project, and report the activation steps. Skill purpose: Run the upstream Flux controller patch release procedure for helm-controller, image-automation-controller, image-reflector-controller, kustomize-controller, notification-controller, source-controller, and source-watcher. Use when preparing a new controller patch release from a release series branch, drafting changelog entries, tagging releases, and opening the follow-up changelog PRs back to main. After the install attempt, report the result to https://www.openagentskill.com/api/agent/outcome with POST JSON {\"event_id\":\"install_\",\"skill_slug\":\"fluxcd-flux-controller-patch-releases\",\"task\":\"Install flux-controller-patch-releases\",\"agent\":\"claude-code\",\"outcome\":\"success\",\"install_used\":true}. Replace event_id with a unique value and outcome with success or failed. Report success only after the skill is installed and a minimal verification passes."},{"id":"cursor","label":"Cursor","kind":"agent-prompt","value":"Turn \"flux-controller-patch-releases\" from https://github.com/fluxcd/agent-skills/tree/main/internal/skills/flux-controller-patch-releases into a reusable Cursor project rule or agent instruction. Preserve the core workflow, adapt paths to this repo, and keep the rule scoped to tasks where it is relevant. Skill purpose: Run the upstream Flux controller patch release procedure for helm-controller, image-automation-controller, image-reflector-controller, kustomize-controller, notification-controller, source-controller, and source-watcher. Use when preparing a new controller patch release from a release series branch, drafting changelog entries, tagging releases, and opening the follow-up changelog PRs back to main. After the install attempt, report the result to https://www.openagentskill.com/api/agent/outcome with POST JSON {\"event_id\":\"install_\",\"skill_slug\":\"fluxcd-flux-controller-patch-releases\",\"task\":\"Install flux-controller-patch-releases\",\"agent\":\"cursor\",\"outcome\":\"success\",\"install_used\":true}. Replace event_id with a unique value and outcome with success or failed. Report success only after the skill is installed and a minimal verification passes."}],"handoff_url":"https://www.openagentskill.com/api/skills/fluxcd-flux-controller-patch-releases/install","manifest_url":"https://www.openagentskill.com/api/registry/manifest/fluxcd-flux-controller-patch-releases"},"trust":{"score":75,"label":"Strong shortlist","version":"trust-score-v4","install_policy":"human_review_before_install","evidence":{"stars":"217 GitHub stars","repoActivity":"217 stars, 9 forks","lastPushed":"5d since push","license":"Apache-2.0","repository":"https://github.com/fluxcd/agent-skills/tree/main/internal/skills/flux-controller-patch-releases","install":"npx skills add fluxcd/agent-skills --skill flux-controller-patch-releases","installSafety":"standard package or runtime install path","permissionSurface":"shell or command execution, filesystem or document access","documentation":"Usable metadata, review docs","agentOutcomes":"No agent outcome data yet"},"outcome_evidence":{"total":0,"successes":0,"failures":0,"not_relevant":0,"success_rate":null,"recent_success_rate":null,"recent_failure_rate":null,"install_attempts":0,"install_success_rate":null,"risk_blocked":0,"setup_required":0,"avg_output_quality":null,"production_outcomes":0,"last_outcome_at":null,"label":"No agent outcome data yet"},"auto_install":{"allowed":false,"sandbox_required":true,"reason":"Human review or sandbox validation is required before automatic installation."},"best_for":["research","agent-skill"],"known_risks":["Quality score needs review","Permission surface needs review: shell or command execution, filesystem or document access","Stars/forks activity: 217 stars, 9 forks; issue activity unavailable in current metadata","Permission surface: shell or command execution, filesystem or document access"]},"agent_proven":{"version":"agent-proven-v1","score":0,"tier":"unproven","label":"Needs first agent run","summary":"No agent outcome reports yet. Use Resolve, run one narrow sandbox task, then report the result.","metrics":{"totalOutcomes":0,"successfulOutcomes":0,"failedOutcomes":0,"installAttempts":0,"installSuccessRate":null,"successRate":null,"recentSuccessRate":null,"recentFailureRate":null,"riskBlocked":0,"setupRequired":0,"notRelevant":0,"avgOutputQuality":null,"avgTimeToUsefulMs":null,"productionOutcomes":0,"humanReviewRequired":0,"uniqueAgents":0,"lastOutcomeAt":null},"signals":[],"penalties":["No real agent outcome evidence yet"]},"audit":{"score":80,"risk_level":"needs_review","risk_label":"Needs review","warnings":["Permission surface may require sandboxing","Quality score needs review","Permission surface needs review: shell or command execution, filesystem or document access","Stars/forks activity: 217 stars, 9 forks; issue activity unavailable in current metadata","Permission surface: shell or command execution, filesystem or document access"]},"safety_gate":{"tier":"experimental","label":"Experimental","auto_install_policy":"review","auto_install_allowed":false,"human_review_required":true,"blocked":false,"recommended_action":"Test manually in an isolated workspace and compare against safer alternatives."},"quality":{"score":70,"label":"Strong"},"supply":{"track":"Research and knowledge work","scenario":"Research agents","maintenance":"5d since push","risk":"Needs review"},"alternative_skills":[],"do_not_use_when":["teams that need a vendor-supported SLA","high-compliance environments without internal security review","No OpenAgentSkill engagement data yet","High-risk permission hints: Shell or command execution","Permission surface may require sandboxing","Quality score needs review","Permission surface needs review: shell or command execution, filesystem or document access","Stars/forks activity: 217 stars, 9 forks; issue activity unavailable in current metadata"],"agent_contract":{"task_input":"Use flux-controller-patch-releases in an agent workflow","recommended_action":"Test manually in an isolated workspace and compare against safer alternatives.","install_policy":"review","minimum_review_before_use":["Trust: 75/100 Strong shortlist","Audit: 80/100 Needs review","Safety: 48/100 Avoid automatic install","Review repository, license, install command, and permission surface before production use."],"expected_agent_output":{"selected_skill":"fluxcd-flux-controller-patch-releases (flux-controller-patch-releases)","install_command":"npx skills add fluxcd/agent-skills --skill flux-controller-patch-releases","risk_summary":"Needs review; Experimental; Review before production","verification_result":"Report the smallest successful task, files touched, warnings, and any missing setup."}},"outcome_feedback":{"endpoint":"https://www.openagentskill.com/api/agent/outcome","method":"POST","requires_resolve_event_id":true,"event_id_source":"Use install_receipt.outcome_feedback.event_id or feedback.event_id returned by /api/agent/resolve for the current task.","expected_outcomes":["success","failed","not_relevant","blocked_by_risk","setup_required"],"payload_template":{"event_id":"","skill_slug":"fluxcd-flux-controller-patch-releases","task":"Use flux-controller-patch-releases in an agent workflow","agent":"codex","outcome":"success","install_used":true,"risk_blocked":false,"setup_required":false,"task_success":true,"output_quality":4,"error_type":null,"human_review_required":false,"workspace":"sandbox","time_to_useful_ms":120000,"notes":"Report the smallest successful task, setup friction, files touched, and risk notes."}},"endpoints":{"web":"https://www.openagentskill.com/skills/fluxcd-flux-controller-patch-releases","api":"https://www.openagentskill.com/api/agent/skills/fluxcd-flux-controller-patch-releases","audit":"https://www.openagentskill.com/skills/fluxcd-flux-controller-patch-releases/audit","eval":"https://www.openagentskill.com/api/agent/evals?slug=fluxcd-flux-controller-patch-releases&task=Use%20flux-controller-patch-releases%20in%20an%20agent%20workflow&max_risk=medium","resolve":"https://www.openagentskill.com/api/agent/resolve?task=Use%20flux-controller-patch-releases%20in%20an%20agent%20workflow&agent=codex&max_risk=medium","receipt":"https://www.openagentskill.com/api/agent/receipt?task=Use%20flux-controller-patch-releases%20in%20an%20agent%20workflow&agent=codex&max_risk=medium&format=text","install":"https://www.openagentskill.com/api/skills/fluxcd-flux-controller-patch-releases/install","manifest":"https://www.openagentskill.com/api/registry/manifest/fluxcd-flux-controller-patch-releases"}},"machine_metadata":{"version":"openagentskill-agent-metadata-v2","skill":{"slug":"fluxcd-flux-controller-patch-releases","name":"flux-controller-patch-releases","description":"Run the upstream Flux controller patch release procedure for helm-controller, image-automation-controller, image-reflector-controller, kustomize-controller, notification-controller, source-controller, and source-watcher. Use when preparing a new controller patch release from a release series branch, drafting changelog entries, tagging releases, and opening the follow-up changelog PRs back to main.","category":"research","url":"https://www.openagentskill.com/skills/fluxcd-flux-controller-patch-releases","repository":"https://github.com/fluxcd/agent-skills/tree/main/internal/skills/flux-controller-patch-releases","github_repo":"fluxcd/agent-skills"},"suited_tasks":["GitHub automation workflows","Claude Code teams","builders willing to evaluate younger projects","Inspect repository metadata","Compare code changes","Write concise engineering summaries","Search sources","Extract claims"],"suited_agents":["Codex","Claude Code","Cursor","OpenAgentSkill CLI","CLI"],"install":{"command":"npx skills add fluxcd/agent-skills --skill flux-controller-patch-releases","ready":true,"targets":[{"id":"openagentskill-cli","label":"CLI","kind":"command","value":"npx --yes https://github.com/Leon-Drq/openagentskill/releases/download/cli-v0.3.0/openagentskill-0.3.0.tgz add fluxcd-flux-controller-patch-releases"},{"id":"codex","label":"Codex","kind":"agent-prompt","value":"Install the \"flux-controller-patch-releases\" agent skill from https://github.com/fluxcd/agent-skills/tree/main/internal/skills/flux-controller-patch-releases. Read its SKILL.md or equivalent instructions first, install only the files needed for this workspace, and summarize any required setup before using it. Skill purpose: Run the upstream Flux controller patch release procedure for helm-controller, image-automation-controller, image-reflector-controller, kustomize-controller, notification-controller, source-controller, and source-watcher. Use when preparing a new controller patch release from a release series branch, drafting changelog entries, tagging releases, and opening the follow-up changelog PRs back to main. After the install attempt, report the result to https://www.openagentskill.com/api/agent/outcome with POST JSON {\"event_id\":\"install_\",\"skill_slug\":\"fluxcd-flux-controller-patch-releases\",\"task\":\"Install flux-controller-patch-releases\",\"agent\":\"codex\",\"outcome\":\"success\",\"install_used\":true}. Replace event_id with a unique value and outcome with success or failed. Report success only after the skill is installed and a minimal verification passes."},{"id":"claude-code","label":"Claude Code","kind":"agent-prompt","value":"Add \"flux-controller-patch-releases\" as a Claude Code skill from https://github.com/fluxcd/agent-skills/tree/main/internal/skills/flux-controller-patch-releases. Inspect the skill instructions, place the reusable skill files in the appropriate local skills location for this project, and report the activation steps. Skill purpose: Run the upstream Flux controller patch release procedure for helm-controller, image-automation-controller, image-reflector-controller, kustomize-controller, notification-controller, source-controller, and source-watcher. Use when preparing a new controller patch release from a release series branch, drafting changelog entries, tagging releases, and opening the follow-up changelog PRs back to main. After the install attempt, report the result to https://www.openagentskill.com/api/agent/outcome with POST JSON {\"event_id\":\"install_\",\"skill_slug\":\"fluxcd-flux-controller-patch-releases\",\"task\":\"Install flux-controller-patch-releases\",\"agent\":\"claude-code\",\"outcome\":\"success\",\"install_used\":true}. Replace event_id with a unique value and outcome with success or failed. Report success only after the skill is installed and a minimal verification passes."},{"id":"cursor","label":"Cursor","kind":"agent-prompt","value":"Turn \"flux-controller-patch-releases\" from https://github.com/fluxcd/agent-skills/tree/main/internal/skills/flux-controller-patch-releases into a reusable Cursor project rule or agent instruction. Preserve the core workflow, adapt paths to this repo, and keep the rule scoped to tasks where it is relevant. Skill purpose: Run the upstream Flux controller patch release procedure for helm-controller, image-automation-controller, image-reflector-controller, kustomize-controller, notification-controller, source-controller, and source-watcher. Use when preparing a new controller patch release from a release series branch, drafting changelog entries, tagging releases, and opening the follow-up changelog PRs back to main. After the install attempt, report the result to https://www.openagentskill.com/api/agent/outcome with POST JSON {\"event_id\":\"install_\",\"skill_slug\":\"fluxcd-flux-controller-patch-releases\",\"task\":\"Install flux-controller-patch-releases\",\"agent\":\"cursor\",\"outcome\":\"success\",\"install_used\":true}. Replace event_id with a unique value and outcome with success or failed. Report success only after the skill is installed and a minimal verification passes."}],"handoff_url":"https://www.openagentskill.com/api/skills/fluxcd-flux-controller-patch-releases/install","manifest_url":"https://www.openagentskill.com/api/registry/manifest/fluxcd-flux-controller-patch-releases"},"trust":{"score":75,"label":"Strong shortlist","version":"trust-score-v4","install_policy":"human_review_before_install","evidence":{"stars":"217 GitHub stars","repoActivity":"217 stars, 9 forks","lastPushed":"5d since push","license":"Apache-2.0","repository":"https://github.com/fluxcd/agent-skills/tree/main/internal/skills/flux-controller-patch-releases","install":"npx skills add fluxcd/agent-skills --skill flux-controller-patch-releases","installSafety":"standard package or runtime install path","permissionSurface":"shell or command execution, filesystem or document access","documentation":"Usable metadata, review docs","agentOutcomes":"No agent outcome data yet"},"outcome_evidence":{"total":0,"successes":0,"failures":0,"not_relevant":0,"success_rate":null,"recent_success_rate":null,"recent_failure_rate":null,"install_attempts":0,"install_success_rate":null,"risk_blocked":0,"setup_required":0,"avg_output_quality":null,"production_outcomes":0,"last_outcome_at":null,"label":"No agent outcome data yet"},"auto_install":{"allowed":false,"sandbox_required":true,"reason":"Human review or sandbox validation is required before automatic installation."},"best_for":["research","agent-skill"],"known_risks":["Quality score needs review","Permission surface needs review: shell or command execution, filesystem or document access","Stars/forks activity: 217 stars, 9 forks; issue activity unavailable in current metadata","Permission surface: shell or command execution, filesystem or document access"]},"agent_proven":{"version":"agent-proven-v1","score":0,"tier":"unproven","label":"Needs first agent run","summary":"No agent outcome reports yet. Use Resolve, run one narrow sandbox task, then report the result.","metrics":{"totalOutcomes":0,"successfulOutcomes":0,"failedOutcomes":0,"installAttempts":0,"installSuccessRate":null,"successRate":null,"recentSuccessRate":null,"recentFailureRate":null,"riskBlocked":0,"setupRequired":0,"notRelevant":0,"avgOutputQuality":null,"avgTimeToUsefulMs":null,"productionOutcomes":0,"humanReviewRequired":0,"uniqueAgents":0,"lastOutcomeAt":null},"signals":[],"penalties":["No real agent outcome evidence yet"]},"audit":{"score":80,"risk_level":"needs_review","risk_label":"Needs review","warnings":["Permission surface may require sandboxing","Quality score needs review","Permission surface needs review: shell or command execution, filesystem or document access","Stars/forks activity: 217 stars, 9 forks; issue activity unavailable in current metadata","Permission surface: shell or command execution, filesystem or document access"]},"safety_gate":{"tier":"experimental","label":"Experimental","auto_install_policy":"review","auto_install_allowed":false,"human_review_required":true,"blocked":false,"recommended_action":"Test manually in an isolated workspace and compare against safer alternatives."},"quality":{"score":70,"label":"Strong"},"supply":{"track":"Research and knowledge work","scenario":"Research agents","maintenance":"5d since push","risk":"Needs review"},"alternative_skills":[],"do_not_use_when":["teams that need a vendor-supported SLA","high-compliance environments without internal security review","No OpenAgentSkill engagement data yet","High-risk permission hints: Shell or command execution","Permission surface may require sandboxing","Quality score needs review","Permission surface needs review: shell or command execution, filesystem or document access","Stars/forks activity: 217 stars, 9 forks; issue activity unavailable in current metadata"],"agent_contract":{"task_input":"Use flux-controller-patch-releases in an agent workflow","recommended_action":"Test manually in an isolated workspace and compare against safer alternatives.","install_policy":"review","minimum_review_before_use":["Trust: 75/100 Strong shortlist","Audit: 80/100 Needs review","Safety: 48/100 Avoid automatic install","Review repository, license, install command, and permission surface before production use."],"expected_agent_output":{"selected_skill":"fluxcd-flux-controller-patch-releases (flux-controller-patch-releases)","install_command":"npx skills add fluxcd/agent-skills --skill flux-controller-patch-releases","risk_summary":"Needs review; Experimental; Review before production","verification_result":"Report the smallest successful task, files touched, warnings, and any missing setup."}},"outcome_feedback":{"endpoint":"https://www.openagentskill.com/api/agent/outcome","method":"POST","requires_resolve_event_id":true,"event_id_source":"Use install_receipt.outcome_feedback.event_id or feedback.event_id returned by /api/agent/resolve for the current task.","expected_outcomes":["success","failed","not_relevant","blocked_by_risk","setup_required"],"payload_template":{"event_id":"","skill_slug":"fluxcd-flux-controller-patch-releases","task":"Use flux-controller-patch-releases in an agent workflow","agent":"codex","outcome":"success","install_used":true,"risk_blocked":false,"setup_required":false,"task_success":true,"output_quality":4,"error_type":null,"human_review_required":false,"workspace":"sandbox","time_to_useful_ms":120000,"notes":"Report the smallest successful task, setup friction, files touched, and risk notes."}},"endpoints":{"web":"https://www.openagentskill.com/skills/fluxcd-flux-controller-patch-releases","api":"https://www.openagentskill.com/api/agent/skills/fluxcd-flux-controller-patch-releases","audit":"https://www.openagentskill.com/skills/fluxcd-flux-controller-patch-releases/audit","eval":"https://www.openagentskill.com/api/agent/evals?slug=fluxcd-flux-controller-patch-releases&task=Use%20flux-controller-patch-releases%20in%20an%20agent%20workflow&max_risk=medium","resolve":"https://www.openagentskill.com/api/agent/resolve?task=Use%20flux-controller-patch-releases%20in%20an%20agent%20workflow&agent=codex&max_risk=medium","receipt":"https://www.openagentskill.com/api/agent/receipt?task=Use%20flux-controller-patch-releases%20in%20an%20agent%20workflow&agent=codex&max_risk=medium&format=text","install":"https://www.openagentskill.com/api/skills/fluxcd-flux-controller-patch-releases/install","manifest":"https://www.openagentskill.com/api/registry/manifest/fluxcd-flux-controller-patch-releases"}},"supply_profile":{"track":{"slug":"research","label":"Research and knowledge work","shortLabel":"Research","description":"Deep research, source comparison, literature review, RAG, knowledge search, and reports."},"scenario":{"label":"Research agents","description":"I need my agent to research a topic, compare sources, and produce a concise report.","useCases":[{"slug":"github-automation","title":"GitHub automation"},{"slug":"research-agents","title":"Research agents"},{"slug":"local-desktop","title":"Local desktop"}]},"applicableAgents":["Claude Code","CLI","Codex","Cursor"],"install":{"ready":true,"command":"npx skills add fluxcd/agent-skills --skill flux-controller-patch-releases","primaryTarget":"CLI","targetCount":4},"githubQuality":{"stars":217,"starsLabel":"217","forks":9,"license":"Apache-2.0","qualityScore":70,"trustScore":75,"auditScore":80},"maintenance":{"status":"fresh","label":"5d since push","daysSincePush":5,"lastPushedAt":"2026-09-01T12:22:17+00:00"},"risk":{"level":"needs_review","label":"Needs review","requiresReview":true,"notes":["Permission surface may require sandboxing","Quality score needs review","Permission surface needs review: shell or command execution, filesystem or document access","Stars/forks activity: 217 stars, 9 forks; issue activity unavailable in current metadata","Permission surface: shell or command execution, filesystem or document access"]},"coverageTags":["Research","Research agents","agent-skill"]},"audit":{"audit_score":80,"risk_level":"needs_review","risk_label":"Needs review","quality_score":70,"trust_score":75,"maintenance_score":100,"security_score":80,"install_score":92,"warnings":["Permission surface may require sandboxing","Quality score needs review","Permission surface needs review: shell or command execution, filesystem or document access","Stars/forks activity: 217 stars, 9 forks; issue activity unavailable in current metadata","Permission surface: shell or command execution, filesystem or document access"]},"quality_signals":{"model":"v2","star_score":16.37,"usage_score":0,"review_score":5.1,"metadata_score":3,"freshness_score":15},"platforms":["Claude Code"],"use_cases":[{"slug":"github-automation","title":"GitHub automation","url":"https://www.openagentskill.com/use-cases/github-automation"},{"slug":"research-agents","title":"Research agents","url":"https://www.openagentskill.com/use-cases/research-agents"},{"slug":"local-desktop","title":"Local desktop","url":"https://www.openagentskill.com/use-cases/local-desktop"},{"slug":"coding-agents","title":"Coding agents","url":"https://www.openagentskill.com/use-cases/coding-agents"}],"stacks":[{"slug":"research-report-agent","title":"Research report agent","url":"https://www.openagentskill.com/collections/research-report-agent"},{"slug":"content-growth-agent","title":"Content growth agent","url":"https://www.openagentskill.com/collections/content-growth-agent"},{"slug":"coding-review-agent","title":"Coding review agent","url":"https://www.openagentskill.com/collections/coding-review-agent"}],"install":"npx skills add fluxcd/agent-skills --skill flux-controller-patch-releases","install_targets":[{"id":"openagentskill-cli","label":"CLI","title":"OpenAgentSkill CLI","kind":"command","value":"npx --yes https://github.com/Leon-Drq/openagentskill/releases/download/cli-v0.3.0/openagentskill-0.3.0.tgz add fluxcd-flux-controller-patch-releases","description":"Resolve policy, run the source installer safely, and report a verified install receipt.","copyLabel":"Copy command"},{"id":"codex","label":"Codex","title":"Codex install prompt","kind":"agent-prompt","value":"Install the \"flux-controller-patch-releases\" agent skill from https://github.com/fluxcd/agent-skills/tree/main/internal/skills/flux-controller-patch-releases. Read its SKILL.md or equivalent instructions first, install only the files needed for this workspace, and summarize any required setup before using it. Skill purpose: Run the upstream Flux controller patch release procedure for helm-controller, image-automation-controller, image-reflector-controller, kustomize-controller, notification-controller, source-controller, and source-watcher. Use when preparing a new controller patch release from a release series branch, drafting changelog entries, tagging releases, and opening the follow-up changelog PRs back to main. After the install attempt, report the result to https://www.openagentskill.com/api/agent/outcome with POST JSON {\"event_id\":\"install_\",\"skill_slug\":\"fluxcd-flux-controller-patch-releases\",\"task\":\"Install flux-controller-patch-releases\",\"agent\":\"codex\",\"outcome\":\"success\",\"install_used\":true}. Replace event_id with a unique value and outcome with success or failed. Report success only after the skill is installed and a minimal verification passes.","description":"Give Codex a repo-aware install prompt when the skill is not available through a local CLI.","copyLabel":"Copy prompt"},{"id":"claude-code","label":"Claude Code","title":"Claude Code skill prompt","kind":"agent-prompt","value":"Add \"flux-controller-patch-releases\" as a Claude Code skill from https://github.com/fluxcd/agent-skills/tree/main/internal/skills/flux-controller-patch-releases. Inspect the skill instructions, place the reusable skill files in the appropriate local skills location for this project, and report the activation steps. Skill purpose: Run the upstream Flux controller patch release procedure for helm-controller, image-automation-controller, image-reflector-controller, kustomize-controller, notification-controller, source-controller, and source-watcher. Use when preparing a new controller patch release from a release series branch, drafting changelog entries, tagging releases, and opening the follow-up changelog PRs back to main. After the install attempt, report the result to https://www.openagentskill.com/api/agent/outcome with POST JSON {\"event_id\":\"install_\",\"skill_slug\":\"fluxcd-flux-controller-patch-releases\",\"task\":\"Install flux-controller-patch-releases\",\"agent\":\"claude-code\",\"outcome\":\"success\",\"install_used\":true}. Replace event_id with a unique value and outcome with success or failed. Report success only after the skill is installed and a minimal verification passes.","description":"Use this prompt to ask Claude Code to add the skill and explain the local activation steps.","copyLabel":"Copy prompt"},{"id":"cursor","label":"Cursor","title":"Cursor rule prompt","kind":"agent-prompt","value":"Turn \"flux-controller-patch-releases\" from https://github.com/fluxcd/agent-skills/tree/main/internal/skills/flux-controller-patch-releases into a reusable Cursor project rule or agent instruction. Preserve the core workflow, adapt paths to this repo, and keep the rule scoped to tasks where it is relevant. Skill purpose: Run the upstream Flux controller patch release procedure for helm-controller, image-automation-controller, image-reflector-controller, kustomize-controller, notification-controller, source-controller, and source-watcher. Use when preparing a new controller patch release from a release series branch, drafting changelog entries, tagging releases, and opening the follow-up changelog PRs back to main. After the install attempt, report the result to https://www.openagentskill.com/api/agent/outcome with POST JSON {\"event_id\":\"install_\",\"skill_slug\":\"fluxcd-flux-controller-patch-releases\",\"task\":\"Install flux-controller-patch-releases\",\"agent\":\"cursor\",\"outcome\":\"success\",\"install_used\":true}. Replace event_id with a unique value and outcome with success or failed. Report success only after the skill is installed and a minimal verification passes.","description":"Use this when installing as Cursor project rules or reusable agent instructions.","copyLabel":"Copy prompt"}],"repository":"https://github.com/fluxcd/agent-skills/tree/main/internal/skills/flux-controller-patch-releases","github_repo":"fluxcd/agent-skills","version":"1.0.0","license":"Apache-2.0","urls":{"web":"https://www.openagentskill.com/skills/fluxcd-flux-controller-patch-releases","repository":"https://github.com/fluxcd/agent-skills/tree/main/internal/skills/flux-controller-patch-releases","api":"/api/agent/skills/fluxcd-flux-controller-patch-releases","install_api":"/api/skills/fluxcd-flux-controller-patch-releases/install"},"meta":{"created_at":"2026-09-03T20:03:26.190809+00:00","updated_at":"2026-09-03T20:03:26.28119+00:00","agent_friendly":true}}