mirror of
https://github.com/affaan-m/everything-claude-code.git
synced 2026-05-17 22:33:06 +08:00
docs: salvage focused skill curation updates (#1723)
Port the safe, narrow pieces from contributor PR #1694 without taking the broad 11-skill rewrite. - add drift-prone warnings to external research/media/API skills - make search-first verify tool availability and use current agent naming - remove unsafe in-memory rate limiter example from backend patterns - tighten the CSP example in security-review Validation: node scripts/ci/validate-skills.js --strict; npx markdownlint targeted skill files; node tests/ci/validators.test.js && node tests/ci/catalog.test.js; npm run lint; node tests/run-all.js
This commit is contained in:
@@ -20,6 +20,10 @@ Use this skill when:
|
||||
|
||||
```
|
||||
┌─────────────────────────────────────────────┐
|
||||
│ 0. TOOL AVAILABILITY PREFLIGHT │
|
||||
│ Check search channels before relying on │
|
||||
│ them; report skipped channels honestly │
|
||||
├─────────────────────────────────────────────┤
|
||||
│ 1. NEED ANALYSIS │
|
||||
│ Define what functionality is needed │
|
||||
│ Identify language/framework constraints │
|
||||
@@ -57,6 +61,19 @@ Use this skill when:
|
||||
|
||||
## How to Use
|
||||
|
||||
### Step 0: Tool Availability Preflight
|
||||
|
||||
This is agent guidance, not an executable setup script. Check only the channels
|
||||
that are relevant to the task and project in front of you.
|
||||
|
||||
| Channel | Check | If missing |
|
||||
|---------|-------|------------|
|
||||
| Repository search | `rg --files` and targeted `rg` queries | State that only visible files were inspected |
|
||||
| Package registry | `npm --version`, `python -m pip --version`, or project package manager | Use web/docs search and avoid claiming registry coverage |
|
||||
| GitHub CLI | `gh auth status` | Use public web or local git history only |
|
||||
| MCP/docs tools | Available tool list or local MCP config | Fall back to official docs/web search |
|
||||
| Skills directory | `ls ~/.claude/skills ~/.codex/skills` where applicable | Say no local skill catalog was available |
|
||||
|
||||
### Quick Mode (inline)
|
||||
|
||||
Before writing a utility or adding functionality, mentally run through:
|
||||
@@ -72,7 +89,7 @@ Before writing a utility or adding functionality, mentally run through:
|
||||
For non-trivial functionality, launch the researcher agent:
|
||||
|
||||
```
|
||||
Task(subagent_type="general-purpose", prompt="
|
||||
Agent(subagent_type="general-purpose", prompt="
|
||||
Research existing tools for: [DESCRIPTION]
|
||||
Language/framework: [LANG]
|
||||
Constraints: [ANY]
|
||||
@@ -82,6 +99,9 @@ Task(subagent_type="general-purpose", prompt="
|
||||
")
|
||||
```
|
||||
|
||||
Older Claude Code docs may call this `Task(...)`; use the current agent/subagent
|
||||
tool name exposed by the active harness.
|
||||
|
||||
## Search Shortcuts by Category
|
||||
|
||||
### Development Tooling
|
||||
@@ -96,7 +116,7 @@ Task(subagent_type="general-purpose", prompt="
|
||||
- Document processing → `unstructured`, `pdfplumber`, `mammoth`
|
||||
|
||||
### Data & APIs
|
||||
- HTTP clients → `httpx` (Python), `ky`/`got` (Node)
|
||||
- HTTP clients → `httpx` (Python), `ky`/`undici` (Node)
|
||||
- Validation → `zod` (TS), `pydantic` (Python)
|
||||
- Database → Check for MCP servers first
|
||||
|
||||
@@ -157,5 +177,6 @@ Result: 1 package + 1 schema file, no custom validation logic
|
||||
|
||||
- **Jumping to code**: Writing a utility without checking if one exists
|
||||
- **Ignoring MCP**: Not checking if an MCP server already provides the capability
|
||||
- **Silent skipping**: Reporting "nothing found" when a search channel was unavailable
|
||||
- **Over-customizing**: Wrapping a library so heavily it loses its benefits
|
||||
- **Dependency bloat**: Installing a massive package for one small feature
|
||||
|
||||
Reference in New Issue
Block a user