@flitzrrr/agent-skills 1.0.3 → 1.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (34) hide show
  1. package/.cursorrules +2 -2
  2. package/.github/copilot-instructions.md +59 -0
  3. package/.lovable +1 -1
  4. package/AGENTS.md +2 -2
  5. package/CHEATSHEET.md +84 -86
  6. package/CLAUDE.md +2 -2
  7. package/LICENSE +27 -0
  8. package/README.md +191 -99
  9. package/bin/build-catalog.js +208 -0
  10. package/bin/cli.js +7 -3
  11. package/bin/rebuild-symlinks.js +161 -0
  12. package/bin/sync-docs.js +147 -0
  13. package/bin/sync-skills.sh +17 -0
  14. package/bin/test-cli.js +115 -0
  15. package/bin/update-wiki.js +102 -0
  16. package/package.json +9 -2
  17. package/skills/dispatch-parallel-agents/skill.md +95 -0
  18. package/skills/execute-work-package/SKILL.md +300 -0
  19. package/skills/execute-work-package/scripts/start-l4l-oci.sh +75 -0
  20. package/skills/execute-work-package/tpl-execution-blueprint.md +39 -0
  21. package/skills/execute-work-package/tpl-execution-digest.md +24 -0
  22. package/skills/execute-work-package/tpl-implementer-execute-prompt.md +57 -0
  23. package/skills/execute-work-package/tpl-implementer-preflight-prompt.md +66 -0
  24. package/skills/product-description-seo/CROSS-SELL.md +31 -0
  25. package/skills/product-description-seo/KEYWORDS.md +35 -0
  26. package/skills/product-description-seo/SKILL.md +361 -0
  27. package/skills/product-description-seo/scripts/analyze_catalog.py +136 -0
  28. package/skills/product-description-seo/scripts/check_quality.py +204 -0
  29. package/skills/product-description-seo/scripts/extract_category.py +88 -0
  30. package/skills/product-description-seo/scripts/track_progress.py +140 -0
  31. package/skills/product-description-seo/scripts/update_catalog.py +80 -0
  32. package/skills/product-description-seo/scripts/validate_json.py +87 -0
  33. package/skills/systematic-debugging/skill.md +87 -0
  34. package/skills/tob-gh-cli/SKILL.md +71 -0
package/skills/tob-gh-cli/SKILL.md ADDED
@@ -0,0 +1,71 @@
1
+ ---
2
+ name: gh-cli
3
+ description: Intercepts GitHub URL fetches and redirects to the authenticated `gh` CLI. Use when Claude tries to access GitHub via WebFetch or curl/wget, when you see 404 errors on private repos, when hitting GitHub API rate limits, or when GitHub API responses are incomplete. Provides hooks that automatically suggest the correct `gh` CLI command for any GitHub URL access pattern.
4
+ ---
5
+
6
+ # GitHub CLI Integration
7
+
8
+ A plugin that intercepts GitHub URL fetches and redirects Claude to use the authenticated `gh` CLI instead.
9
+
10
+ ## Problem
11
+
12
+ Claude Code's `WebFetch` tool and Bash `curl`/`wget` commands don't use the user's GitHub authentication. This means:
13
+
14
+ - **Private repos**: Fetches fail with 404 errors
15
+ - **Rate limits**: Unauthenticated requests are limited to 60/hour (vs 5,000/hour authenticated)
16
+ - **Missing data**: Some API responses are incomplete without authentication
17
+
18
+ ## Solution
19
+
20
+ This plugin provides PreToolUse hooks that intercept GitHub URL access via `WebFetch` or `curl`/`wget`, and suggest the correct `gh` CLI command.
21
+
22
+ ### What Gets Intercepted
23
+
24
+ | Tool | Pattern | Suggestion |
25
+ |------|---------|------------|
26
+ | `WebFetch` | `github.com/{owner}/{repo}` | `gh repo view owner/repo` |
27
+ | `WebFetch` | `github.com/.../blob/...` | `gh repo clone` + Read |
28
+ | `WebFetch` | `github.com/.../tree/...` | `gh repo clone` + Read/Glob/Grep |
29
+ | `WebFetch` | `api.github.com/repos/.../pulls` | `gh pr list` / `gh pr view` |
30
+ | `WebFetch` | `api.github.com/repos/.../issues` | `gh issue list` / `gh issue view` |
31
+ | `WebFetch` | `api.github.com/...` | `gh api <endpoint>` |
32
+ | `WebFetch` | `raw.githubusercontent.com/...` | `gh repo clone` + Read |
33
+ | `Bash` | `curl https://api.github.com/...` | `gh api <endpoint>` |
34
+ | `Bash` | `curl https://raw.githubusercontent.com/...` | `gh repo clone` + Read |
35
+ | `Bash` | `wget https://github.com/...` | `gh release download` |
36
+
37
+ ### What Passes Through
38
+
39
+ - Non-GitHub URLs
40
+ - GitHub Pages sites (`*.github.io`)
41
+ - Commands already using `gh` (except anti-patterns)
42
+ - Git commands (`git clone`, `git push`, etc.)
43
+ - Search commands that mention GitHub URLs (`grep`, `rg`, etc.)
44
+
45
+ ## Prerequisites
46
+
47
+ - [GitHub CLI (`gh`)](https://cli.github.com/) must be installed and authenticated (`gh auth login`)
48
+ - If `gh` is not installed, the hooks pass through without disruption
49
+
50
+ ## Usage
51
+
52
+ This skill operates automatically via hooks. No manual invocation required. When you attempt to access GitHub URLs, the hooks will intercept and suggest the authenticated alternative.
53
+
54
+ ### Common gh CLI Commands
55
+
56
+ ```bash
57
+ # View repo info
58
+ gh repo view owner/repo
59
+
60
+ # List PRs
61
+ gh pr list --repo owner/repo
62
+
63
+ # View a specific PR
64
+ gh pr view 123 --repo owner/repo
65
+
66
+ # API access
67
+ gh api repos/owner/repo/pulls
68
+
69
+ # Clone a repo
70
+ gh repo clone owner/repo
71
+ ```