auto-updater

Check pinned community skills for newer commit SHAs and prepare reviewable diffs.

Updated Dec 4, 2025
One-click install
npx skills add https://github.com/PolliticalSolutions/political-portal --skill auto-updater-polliticalsolutions
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: auto-updater
Source: https://github.com/PolliticalSolutions/political-portal/tree/main/.claude/skills/legal-builder-hub/auto-updater
Command: npx skills add https://github.com/PolliticalSolutions/political-portal --skill auto-updater-polliticalsolutions

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It prevents unreviewed changes to installed community skills by forcing a human trust check before any update is applied.

Core Features & Use Cases

  • Immutable pin checks: Fetches the latest source commit SHA and compares it to what was installed, avoiding mutable tags.
  • Reviewable diffs: Produces detailed unified diffs, with special emphasis on security-sensitive files like hooks and MCP configuration.
  • Guardrailed update safety: Refuses updates when scan/regression rules indicate increased risk, and always requires explicit approval for high-surface security changes.
  • Freshness re-verification: Detects stale skills beyond their verified freshness window and prompts re-validation.

Quick Start

Run auto-updater to check for installed skill updates, review the diff it shows, and approve only after confirming the security-impacting changes.

Frequently Asked Questions about auto-updater

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I safely review skill updates before applying them?

To safely review skill updates, you need a process that checks pinned community skills for newer commit SHAs and generates per-skill diffs for human trust review. This enforces explicit approval before overwriting installed files.

What security guardrails should I check for when updating hooks and MCP configurations?

Security guardrails for updating hooks and MCP configurations must enforce fail-closed checks for hook execution, MCP credential access, and tool permission changes. A fresh-reference scan gate should run prior to overwriting installed skill files.

How do immutable commit SHA checks prevent unreviewed changes to installed skills?

Immutable commit SHA checks prevent unreviewed changes by fetching the latest source commit SHA and comparing it to the installed version. This avoids mutable tags and ensures only explicitly approved updates are applied to your skills.

How does freshness verification work for detecting stale community skills?

Freshness verification detects stale skills by tracking their verified freshness window. When a skill exceeds this window, the system prompts re-validation to ensure the installed version remains trusted and secure against upstream behavior changes.

When should I require explicit approval for high-surface security changes in skill updates?

You should require explicit approval for high-surface security changes whenever scan or regression rules indicate increased risk. The system refuses updates automatically if these fail-closed security checks detect unauthorized hook execution or tool permission modifications.