bg-szy/TOP-SKILLS / skills/agent-skills/custom-agent-usage
custom-agent-usage
VerifiedDiscover, validate, and invoke .agent.md custom agents. Use when finding agent files in the local Claude or VS Code Insiders directories, checking frontmatter, verifying disable-model-invocation, or determining agentName for runSubagent calls.
| File | Kind | Size |
|---|---|---|
| CHANGELOG.md | markdown | 7.4 KB |
| LICENSE.txt | markdown | 1.1 KB |
| SKILL.md | skill md | 7.1 KB |
CHANGELOG.md
View on GitHub# Changelog
## [2026-11-16] - Make Windows Paths Portable
### Changed
- Replaced account-specific Windows paths with `%USERPROFILE%`, `%APPDATA%`,
and PowerShell environment-based path construction.
## [2026-09-08] - Catalog Freshness And Source Sync
### Added
- Refreshed the catalog metadata and retained-client portability baseline.
### Changed
- Updated the catalog metadata and last-updated state for the 2026-09-08 maintenance pass.
- Kept the retained-client portability, MCP fallback, Anti-Patterns, Verification Protocol, and Related Skills sections aligned.
### Fixed
- Preserved explicit no-MCP fallbacks and the catalog's safety, approval, and source-boundary guidance.
## [2026-09-05] - Catalog Freshness And Source Sync
### Added
- Refreshed the catalog metadata and retained-client portability baseline.
### Changed
- Updated the catalog metadata and last-updated state for the 2026-09-05 maintenance pass.
- Kept the retained-client portability, MCP fallback, Anti-Patterns, Verification Protocol, and Related Skills sections aligned.
### Fixed
- Preserved explicit no-MCP fallbacks and the catalog's safety, approval, and source-boundary guidance.
## [2026-08-31] - Catalog Freshness And Source Sync
### Added
- Refreshed the catalog metadata and retained-client portability baseline.
### Changed
- Updated the catalog metadata and last-updated state for the 2026-08-31 maintenance pass.
- Kept the retained-client portability, MCP fallback, Anti-Patterns, Verification Protocol, and Related Skills sections aligned.
### Fixed
- Preserved explicit no-MCP fallbacks and the catalog's safety, approval, and source-boundary guidance.
## [2026-08-29] - Catalog Freshness And Source Sync
### Added
- Refreshed the catalog metadata and retained-client portability baseline.
### Changed
- Updated the catalog metadata and last-updated state for the 2026-08-29 maintenance pass.
- Kept the retained-client portability, MCP fallback, Anti-Patterns, Verification Protocol, and Related Skills sections aligned.
### Fixed
- Preserved explicit no-MCP fallbacks and the catalog's safety, approval, and source-boundary guidance.
## [2026-08-24] - Catalog Freshness And Source Sync
### Added
- Refreshed the catalog metadata and retained-client portability baseline.
### Changed
- Updated the catalog metadata and last-updated state for the 2026-08-24 maintenance pass.
- Kept the retained-client portability, MCP fallback, Anti-Patterns, Verification Protocol, and Related Skills sections aligned.
### Fixed
- Preserved explicit no-MCP fallbacks and the catalog's safety, approval, and source-boundary guidance.
## [2026-08-14] - Catalog Freshness And Source Sync
### Added
- Refreshed the catalog metadata and retained-client portability baseline.
### Changed
- Updated the catalog metadata and last-updated state for the 2026-08-14 maintenance pass.
- Kept the retained-client portability, MCP fallback, Anti-Patterns, Verification Protocol, and Related Skills sections aligned.
### Fixed
- Preserved explicit no-MCP fallbacks and the catalog's safety, approval, and source-boundary guidance.
## [2026-07-29] - Version 2.0 Client Support Reset
### Added
- Added the current GitHub Copilot, Claude Code, and Codex portability baseline.
### Changed
- **BREAKING:** Removed Gemini CLI and Antigravity as supported clients.
- Refreshed catalog metadata and last-updated state for the 2026-07-29 maintenance pass.
- Kept the retained-client portability, MCP fallback, Anti-Patterns, Verification Protocol, and Related Skills sections aligned.
### Fixed
- Prevented catalog modernization from reintroducing removed Gemini or Antigravity guidance.
## [2026-07-11] - Catalog Maintenance Refresh
### Added
- Added the current catalog verification baseline where it was missing.
### Changed
- Refreshed catalog metadata and last-updated state for the 2026-07-11 maintenance pass.
- Kept the cross-client, MCP fallback, Anti-Patterns, Verification Protocol, and Related Skills sections aligned.
- Reclassified historical `Tested` or `Verified` changelog headings under the allowed changelog vocabulary without dropping their evidence.
### Fixed
- Closed validator and documentation drift so the enforced schema matches the documented skill baseline.
## [2026-04-25] - Version 1.2 Verification Protocol Refresh
### Added
- Added a `Verification Protocol` section with skill-specific pass/fail checks, one pressure-test scenario, and a measurable success metric.
- Added guidance to leverage native parallel subagent dispatch and 200k+ context windows where available.
### Changed
- Updated `SKILL.md` frontmatter to `version: "1.2"` and `last_updated: 2026-04-25`.
- Reframed activation guidance toward symptom -> action triggers and standardized two-stage review wording where applicable.
## [2026-04-24] - Version 1.1 Refresh
### Changed
- Updated the SKILL frontmatter version to `1.1` for the 2026-04-24 catalog refresh.
## [2026-04-24] - Skill Refresh
### Changed
- Standardized the SKILL frontmatter with version metadata, last-updated date, tags, and a concise catalog description.
- Reformatted the portability and MCP guidance with a preferred server line, a copy-paste fallback prompt, and consistent bullet lists.
- Added a catalog-standard Anti-Patterns section and refreshed the Related Skills links at the end of the skill.
## [2026-04-24] - Catalog Audit Cleanup
### Fixed
- Removed obsolete standalone Skill Paths guidance that duplicated the generated portability section.
All notable changes to this skill will be documented in this file.
## [2026-04-04] - Cross-Client Portability Refresh
### Changed
- Added a standard portability note covering GitHub Copilot, Claude Code, Codex, and Gemini CLI.
- Clarified that the core workflow does not require a dedicated MCP server and can run with local tools alone.
### Changed
- Validated `SKILL.md` frontmatter, portability sections, and Gemini export readiness with `python scripts/validate-skills.py`.
## [2026-03-09] - Custom Agent Discovery Correction
### Changed
- Repointed custom-agent discovery guidance to the real local agent directories: `%USERPROFILE%\.claude\agents` and `%USERPROFILE%\AppData\Roaming\Code - Insiders\User\prompts`
- Updated the examples to search those directories directly instead of treating repo-local Copilot paths as the primary discovery roots
### Fixed
- Removed the stale `.copilot/agents` and `.github/copilot/agents` discovery guidance
- Clarified that the VS Code Insiders prompts directory also contains `.prompt.md` and `.instructions.md`, so discovery must filter to `*.agent.md`
- Removed the external `glob` dependency from the helper script so it runs in the plain local Node environment used in this workspace
### Changed
- Checked the real local directories on this machine and confirmed both exist
- Verified the correction against the files currently present in the Claude and VS Code Insiders agent directories
## [2026-03-09] - Workspace Modernization
### Changed
- Updated the workspace and global skill path guidance to match the current `%USERPROFILE%/.agents/skills/` fallback path
- Removed duplicate related-skill content so the skill reads cleanly
## [2026-02-28] - Description Rewrite & Cross-References
### Changed
- Rewrote skill description to ~200 characters with clear, specific activation keywords
- Improved keyword specificity to reduce overlap with related skills
### Added
- `## Related Skills` cross-reference table with 2-4 related skills and "Use When" guidance
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 472k | Updated | Claude CodeCodex | Unverified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |