skills.rest
tariqwest
tariqwestCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

refresh-catalog

Re-research and update catalog rows with live version, license, popularity, and URL data.

Updated Aug 18, 2026
Search Tags:#catalog#metadata#version tracking#refresh#github api#dry-run#revalidation
One-click install
npx skills add https://github.com/tariqwest/ai-client-catalog --skill refresh-catalog-tariqwest
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: refresh-catalog
Source: https://github.com/tariqwest/ai-client-catalog/tree/main/.agents/skills/refresh-catalog
Command: npx skills add https://github.com/tariqwest/ai-client-catalog --skill refresh-catalog-tariqwest

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Catalog entries for tools and projects go stale over time as versions change, licenses update, and URLs break. This Skill re-validates one, a subset, or all rows in the catalog master table against live sources, updating only what has drifted and leaving valid rows untouched. ## Core Features & Use Cases - Flexible Scope Selection: Refresh a single entry by id, uid, or free-text query, a filtered subset (e.g. by vendor, type, or license), or the entire table. - Live Data Re-Research: Pulls latest version from release endpoints, license SPDX IDs, GitHub star counts for popularity, and validates homepage and repository URLs with HEAD requests. - Dry-Run and Field Control: Preview drift without writing using dryRun, limit updates to specific columns, and control fetch concurrency. - Use Case: Run a dry-run refresh filtered to a single vendor to see which entries have stale versions before committing updates to the catalog master table. ## Quick Start Ask the agent to refresh the catalog entry for a specific tool by name, or to dry-run a refresh of all rows showing only version and popularity changes.

Frequently Asked Questions about refresh-catalog

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

FAQPage Schema
How do I refresh a single catalog entry?▼

Pass a single id, uid, or free-text query parameter, such as {"id": "claude"} or {"query": "Warp Terminal"}. These are treated as sugar for a one-element ids list and refresh only that row.

How do I update only some rows in a catalog table?▼

Use the filter parameter with expressions like vendor:Anthropic, type:Workspace app, or license:MIT to select a subset of rows. Prefix with ! to negate and use commas to AND multiple conditions.

Can I preview catalog changes without writing them?▼

Yes, set dryRun to true to report drift without modifying the table. The report shows up-to-date, stale, broken-url, and fetch-failed rows, with diff previews for the first three stale rows.

What data sources does catalog revalidation use?▼

It fetches the latest release tag for version, the license endpoint for SPDX IDs, GitHub stargazers_count for popularity, and HEAD requests for homepage and repository URLs. Distribution data is re-scraped from READMEs and package registries like npm, cargo, and pypi.

What happens when a catalog refresh fetch fails?▼

When a fetch returns null or 404, the row is marked fetch-failed and the stored value is kept as-is. Failed rows are reported separately so they can be flagged for manual review rather than overwritten.

Related Skills

Explore More Software Engineering Skills→
mattbutlerengineeringmattbutlerengineering
2

add-catalog-entry

Automates the eight-file workflow for adding a catalogued tool to CATALOG.md and COMPARISON.md.

Community
Advanced
luxury-yachtluxury-yacht
411

browse-tables

Implement catalog-backed browse and refresh behavior for Kubernetes cluster and namespace tables.

Official
Advanced
josemariafsjosemariafs
3

bmad-customize

Translate user intent into TOML overrides for BMad skills under _bmad/custom.

Community
Intermediate
smitkhanparaZurusmitkhanparaZuru

sync-workflow

Incrementally merge artifacts, extract ASTs, and update graphs for AICA repositories.

Community
Advanced