Skip to content

Add better descriptions#9

Open
dhruvchand wants to merge 1 commit into
mainfrom
prune-skills
Open

Add better descriptions#9
dhruvchand wants to merge 1 commit into
mainfrom
prune-skills

Conversation

@dhruvchand

Copy link
Copy Markdown
Collaborator

Add better descriptions

Copilot AI review requested due to automatic review settings July 17, 2026 17:41

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Pull request overview

Improves catalog descriptions for many agent skills, but also unexpectedly removes valid catalog entries.

Changes:

  • Replaces generic descriptions with more specific summaries.
  • Deletes entries from Venice, Typefully, mcp-use, and fal.ai.
  • Introduces several minor description errors.
Show a summary per file
File Description
catalog/vercel-labs/vercel-sandbox.json Improves description.
catalog/vercel-labs/slack.json Improves description.
catalog/vercel-labs/electron.json Improves description.
catalog/vercel-labs/dogfood.json Improves description.
catalog/vercel-labs/core.json Improves description.
catalog/vercel-labs/agentcore.json Improves description.
catalog/vercel-labs/agent-browser.json Improves description.
catalog/veniceai/venice-x402.json Deletes catalog entry.
catalog/veniceai/venice-video.json Deletes catalog entry.
catalog/veniceai/venice-responses.json Deletes catalog entry.
catalog/veniceai/venice-models.json Deletes catalog entry.
catalog/veniceai/venice-image-generate.json Deletes catalog entry.
catalog/veniceai/venice-image-edit.json Deletes catalog entry.
catalog/veniceai/venice-errors.json Deletes catalog entry.
catalog/veniceai/venice-embeddings.json Deletes catalog entry.
catalog/veniceai/venice-crypto-rpc.json Deletes catalog entry.
catalog/veniceai/venice-chat.json Deletes catalog entry.
catalog/veniceai/venice-characters.json Deletes catalog entry.
catalog/veniceai/venice-billing.json Deletes catalog entry.
catalog/veniceai/venice-auth.json Deletes catalog entry.
catalog/veniceai/venice-augment.json Deletes catalog entry.
catalog/veniceai/venice-audio-transcription.json Deletes catalog entry.
catalog/veniceai/venice-audio-speech.json Deletes catalog entry.
catalog/veniceai/venice-audio-music.json Deletes catalog entry.
catalog/veniceai/venice-api-overview.json Deletes catalog entry.
catalog/veniceai/venice-api-keys.json Deletes catalog entry.
catalog/veniceai/my-venice-skill.json Deletes template entry.
catalog/typefully/typefully.json Deletes catalog entry.
catalog/sveltejs/writing-opencode-plugins.json Improves description.
catalog/sveltejs/writing-great-skills.json Improves description.
catalog/sveltejs/svelte-core-bestpractices.json Improves description.
catalog/sveltejs/svelte-code-writer.json Improves description.
catalog/qdrant/vertical-scaling.json Improves description.
catalog/qdrant/tenant-scaling.json Improves description.
catalog/qdrant/sliding-time-window.json Improves description.
catalog/qdrant/setup.json Improves description.
catalog/qdrant/search-types.json Improves description.
catalog/qdrant/search-strategies.json Improves description.
catalog/qdrant/search-speed-optimization.json Improves description.
catalog/qdrant/scaling-query-volume.json Improves description.
catalog/qdrant/scaling-qps.json Improves description.
catalog/qdrant/scaling-data-volume.json Improves description.
catalog/qdrant/relevance-feedback.json Improves description.
catalog/qdrant/qdrant-version-upgrade.json Improves description.
catalog/qdrant/qdrant-search-quality.json Improves description.
catalog/qdrant/qdrant-scaling.json Improves description.
catalog/qdrant/qdrant-performance-optimization.json Improves description.
catalog/qdrant/qdrant-monitoring.json Improves description.
catalog/qdrant/qdrant-model-migration.json Improves description.
catalog/qdrant/qdrant-edge.json Improves description.
catalog/qdrant/qdrant-deployment-options.json Improves description.
catalog/qdrant/qdrant-clients-sdk.json Improves description.
catalog/qdrant/qdrant-advisor.json Improves description.
catalog/qdrant/minimize-latency.json Improves description.
catalog/qdrant/memory-usage-optimization.json Improves description.
catalog/qdrant/indexing-performance-optimization.json Improves description.
catalog/qdrant/hybrid-search.json Improves description.
catalog/qdrant/horizontal-scaling.json Improves description.
catalog/qdrant/diagnosis.json Improves description.
catalog/qdrant/debugging.json Improves description.
catalog/qdrant/combining-searches.json Improves description.
catalog/pinecone-io/quickstart.json Improves description.
catalog/pinecone-io/query.json Improves description.
catalog/pinecone-io/n8n.json Improves description.
catalog/pinecone-io/mcp.json Improves description.
catalog/pinecone-io/help.json Improves description.
catalog/pinecone-io/full-text-search.json Improves description.
catalog/pinecone-io/docs.json Improves description.
catalog/pinecone-io/cli.json Improves description.
catalog/pinecone-io/assistant.json Improves description.
catalog/payloadcms/ui4.json Improves description.
catalog/payloadcms/ui4-review.json Improves description.
catalog/payloadcms/ui4-convert-tests.json Improves description.
catalog/payloadcms/triage-ci-flake.json Improves description.
catalog/payloadcms/generate-translations.json Updates description with grammar error.
catalog/payloadcms/audit-dependencies.json Improves description.
catalog/nvidia/physical-ai-video-data-augmentation.json Improves description.
catalog/nvidia/physical-ai-neural-reconstruction.json Improves description.
catalog/nvidia/physical-ai-infrastructure-setup-and-resilient-scaling.json Improves description.
catalog/nvidia/physical-ai-defect-image-generation.json Improves description.
catalog/nvidia/omniverse-usd-performance-tuning.json Improves description.
catalog/nvidia/omniverse-realtime-viewer.json Improves description.
catalog/nvidia/omniverse-cad-to-simready.json Improves description.
catalog/nvidia/nemotron-speech.json Improves description.
catalog/nvidia/nemo-retriever.json Improves description.
catalog/nvidia/cuopt-user-rules.json Improves description.
catalog/nvidia/cuopt-skill-evolution.json Improves description.
catalog/nvidia/cuopt-server-api-python.json Improves description.
catalog/nvidia/cuopt-routing-api-python.json Improves description.
catalog/nvidia/cuopt-numerical-optimization-formulation.json Improves description.
catalog/nvidia/cuopt-numerical-optimization-api-c.json Improves description.
catalog/nvidia/cuopt-multi-objective-exploration.json Omits “epsilon” term.
catalog/nvidia/cuopt-install.json Improves description.
catalog/nvidia/cuopt-developer.json Improves description.
catalog/mcp-use/openapi-to-mcp.json Deletes catalog entry.
catalog/mcp-use/mcp-builder.json Deletes catalog entry.
catalog/mcp-use/mcp-apps-builder.json Deletes catalog entry.
catalog/mcp-use/chatgpt-app-builder.json Deletes catalog entry.
catalog/google/workload-manager-basics.json Improves description.
catalog/google/google-cloud-waf-sustainability.json Improves description.
catalog/google/google-cloud-waf-security.json Improves description.
catalog/google/google-cloud-waf-reliability.json Improves description.
catalog/google/google-cloud-waf-performance-optimization.json Improves description.
catalog/google/google-cloud-waf-operational-excellence.json Improves description.
catalog/google/google-cloud-waf-cost-optimization.json Improves description.
catalog/google/google-cloud-recipe-onboarding.json Improves description.
catalog/google/google-cloud-recipe-auth.json Improves description.
catalog/google/google-cloud-networking-observability.json Improves description.
catalog/google/gke-basics.json Improves description.
catalog/google/gemini-interactions-api.json Improves description.
catalog/google/gemini-api.json Improves description.
catalog/google/gemini-agents-api.json Improves description.
catalog/google/gcloud.json Improves description.
catalog/google/firebase-basics.json Improves description.
catalog/google/cloud-sql-basics.json Improves description.
catalog/google/cloud-run-basics.json Improves description.
catalog/google/bigquery-basics.json Improves description.
catalog/google/alloydb-basics.json Improves description.
catalog/google/agent-platform-tuning.json Improves description.
catalog/google/agent-platform-tuning-management.json Improves description.
catalog/google/agent-platform-skill-registry.json Improves description.
catalog/google/agent-platform-rag-engine-management.json Improves description.
catalog/google/agent-platform-prompt-management.json Improves description.
catalog/google/agent-platform-model-registry.json Improves description.
catalog/google/agent-platform-migrate-from-ai-studio.json Improves description.
catalog/google/agent-platform-inference.json Improves description.
catalog/google/agent-platform-eval-flywheel.json Improves description.
catalog/google/agent-platform-endpoint-management.json Improves description.
catalog/google/agent-platform-deploy.json Improves description.
catalog/fal-ai-community/ugc.json Deletes catalog entry.
catalog/fal-ai-community/storytelling.json Deletes catalog entry.
catalog/fal-ai-community/model-routing.json Deletes catalog entry.
catalog/fal-ai-community/marketing.json Deletes catalog entry.
catalog/fal-ai-community/genmedia.json Deletes catalog entry.
catalog/fal-ai-community/genmedia-workflow.json Deletes catalog entry.
catalog/fal-ai-community/fan-cam.json Deletes catalog entry.
catalog/fal-ai-community/fal-workflow.json Deletes catalog entry.
catalog/fal-ai-community/fal-regenerate-3d.json Deletes catalog entry.
catalog/fal-ai-community/fal-redesign.json Deletes catalog entry.
catalog/fal-ai-community/fal-recipes.json Deletes catalog entry.
catalog/fal-ai-community/fal-prompting.json Deletes catalog entry.
catalog/fal-ai-community/fal-models-catalog.json Deletes catalog entry.
catalog/fal-ai-community/fal-gamedev.json Deletes catalog entry.
catalog/fal-ai-community/commercial.json Deletes catalog entry.
catalog/fal-ai-community/cinematography.json Deletes catalog entry.
catalog/fal-ai-community/character-design.json Deletes catalog entry.
catalog/exa-labs/search.json Improves description.
catalog/exa-labs/agent.json Improves description.
catalog/denoland/deno-sandbox.json Improves description.
catalog/denoland/deno-project-templates.json Improves description.
catalog/denoland/deno-guidance.json Improves description.
catalog/denoland/deno-frontend.json Improves description.
catalog/denoland/deno-expert.json Improves description.
catalog/denoland/deno-deploy.json Improves description.
catalog/dbt-labs/auditing-skills.json Improves description.
catalog/chromedevtools/troubleshooting.json Improves description.
catalog/chromedevtools/memory-leak-debugging.json Improves description.
catalog/chromedevtools/debug-optimize-lcp.json Improves description.
catalog/chromedevtools/chrome-devtools.json Improves description.
catalog/chromedevtools/chrome-devtools-cli.json Improves description.
catalog/chromedevtools/a11y-debugging.json Improves description.
catalog/browserbase/safe-browser.json Improves description.
catalog/better-auth/security.json Improves description.
catalog/axiomhq/find-traces.json Improves description.
catalog/axiomhq/explore-dataset.json Improves description.
catalog/axiomhq/detect-anomalies.json Improves description.
catalog/axiomhq/axiom-apl.json Improves description.
catalog/astronomer/warehouse-init.json Improves description.
catalog/astronomer/troubleshooting-astro-deployments.json Improves description.
catalog/astronomer/tracing-upstream-lineage.json Improves description.
catalog/astronomer/tracing-downstream-lineage.json Improves description.
catalog/astronomer/testing-dags.json Improves description.
catalog/astronomer/setting-up-astro-project.json Improves description.
catalog/astronomer/profiling-tables.json Improves description.
catalog/astronomer/migrating-dagster-to-airflow.json Improves description.
catalog/astronomer/migrating-airflow-2-to-3.json Improves description.
catalog/astronomer/migrating-ai-sdk-to-common-ai.json Improves description.
catalog/astronomer/managing-astro-local-env.json Improves description.
catalog/astronomer/managing-astro-deployments.json Improves description.
catalog/astronomer/deploying-go-sdk-bundles.json Improves description.
catalog/astronomer/deploying-airflow.json Improves description.
catalog/astronomer/delegating-to-otto.json Improves description.
catalog/astronomer/debugging-dags.json Adds duplicated spacing.
catalog/astronomer/dag-factory.json Improves description.
catalog/astronomer/creating-openlineage-extractors.json Improves description.
catalog/astronomer/cosmos-dbt-fusion.json Improves description.
catalog/astronomer/cosmos-dbt-core.json Improves description.
catalog/astronomer/configuring-airflow-language-sdks.json Improves description.
catalog/astronomer/checking-freshness.json Improves description.
catalog/astronomer/blueprint.json Improves description.
catalog/astronomer/authoring-language-sdk-tasks.json Improves description.
catalog/astronomer/authoring-go-sdk-tasks.json Improves description.
catalog/astronomer/authoring-dags.json Improves description.
catalog/astronomer/annotating-task-lineage.json Improves description.
catalog/astronomer/analyzing-data.json Improves description.
catalog/astronomer/airflow.json Improves description.
catalog/astronomer/airflow-state-store.json Improves description.
catalog/astronomer/airflow-plugins.json Improves description.
catalog/astronomer/airflow-hitl.json Improves description.
catalog/astronomer/airflow-adapter.json Improves description.
catalog/apify/apify-ultimate-scraper.json Improves description.
catalog/apify/apify-sdk-integration.json Improves description.
catalog/apify/apify-generate-output-schema.json Improves description.
catalog/apify/apify-actorization.json Improves description.
catalog/apify/apify-actor-development.json Improves description.

Review details

Tip

Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comments suppressed due to low confidence (4)

catalog/veniceai/venice-x402.json:1

  • These 19 Venice skill definitions still exist at their linked paths in veniceai/skills, so deleting this file and the other Venice entries removes valid resources from agent-finder search results. This is unrelated to the stated description-only update; restore the valid Venice catalog files (the template entry can be assessed separately).
    catalog/typefully/typefully.json:1
  • The linked Typefully skill still exists, so this deletion removes a valid resource from the catalog rather than improving its description. Restore the entry; its description can be updated independently if needed.
    catalog/mcp-use/openapi-to-mcp.json:1
  • All four deleted mcp-use skill directories still exist at the linked paths in mcp-use/mcp-use. Removing their catalog registrations is an unrelated functional change that makes valid skills undiscoverable; restore these entries and limit this PR to description updates.
    catalog/fal-ai-community/ugc.json:1
  • The deleted fal.ai community skills still exist under the exact linked paths in fal-ai-community/skills. These removals make valid resources disappear from the catalog and are outside this description-only PR; restore the affected fal.ai entries.
  • Files reviewed: 205/205 changed files
  • Comments generated: 3
  • Review effort level: Medium

"mediaType": "application/ai-skill",
"url": "https://github.com/NVIDIA/cuopt/blob/main/skills/cuopt-multi-objective-exploration/SKILL.md",
"description": "NVIDIA skill definition for cuopt-multi-objective-exploration.",
"description": "Trace and interpret the Pareto frontier across competing objectives using repeated single-objective cuOpt solves (weighted-sum and -constraint).",
"mediaType": "application/ai-skill",
"url": "https://github.com/payloadcms/payload/blob/main/.claude/skills/generate-translations/SKILL.md",
"description": "Generate Translations skill.",
"description": "Use when new translation keys are added to packages to generate new translations strings",
"mediaType": "application/ai-skill",
"url": "https://github.com/astronomer/agents/blob/main/skills/debugging-dags/SKILL.md",
"description": "Debugging Dags skill.",
"description": "Comprehensive DAG failure diagnosis and root-cause analysis with structured investigation and prevention recommendations.",
Remove 4 publishers with low trust signals:
- mcp-use (4 entries) - small utility project, no established company
- typefully (1 entry) - tiny SaaS, 25 GitHub followers
- veniceai (20 entries) - unestablished startup, 201 followers
- fal-ai-community (17 entries) - community-run, not official fal.ai

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants