mirror of
https://github.com/affaan-m/everything-claude-code.git
synced 2026-05-04 16:03:29 +08:00
Compare commits
490 Commits
v1.10.0
...
dependabot
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
97e205548a | ||
|
|
841beea45c | ||
|
|
61992f7f5e | ||
|
|
2715315438 | ||
|
|
7627926216 | ||
|
|
20154ddb22 | ||
|
|
bb40978e31 | ||
|
|
7c5452f4fa | ||
|
|
cfe770a735 | ||
|
|
4c8499d509 | ||
|
|
85dfb5e5fc | ||
|
|
7b03a60503 | ||
|
|
fbd441b448 | ||
|
|
99177e81ea | ||
|
|
b6a7f8ab0c | ||
|
|
c9962bf83e | ||
|
|
38f4265a1c | ||
|
|
b1456bd954 | ||
|
|
95bef977c1 | ||
|
|
e381c8d8a8 | ||
|
|
08d6c82989 | ||
|
|
9a3f72712b | ||
|
|
708a8fd715 | ||
|
|
9aace2e6fe | ||
|
|
fb6cc8548b | ||
|
|
b8452dc108 | ||
|
|
2fd8dfc7e1 | ||
|
|
158cbd8979 | ||
|
|
3e18127a3d | ||
|
|
63c97b4c26 | ||
|
|
70cc2bb247 | ||
|
|
01d3743a8c | ||
|
|
a374eaf49d | ||
|
|
d05855be5f | ||
|
|
803abe52a5 | ||
|
|
e1d6d853f7 | ||
|
|
5881554a1c | ||
|
|
d26d66fd3b | ||
|
|
0c61710c43 | ||
|
|
d49f0329a9 | ||
|
|
95ce9eaaeb | ||
|
|
06f9eca8e2 | ||
|
|
affbd33485 | ||
|
|
9627c201c7 | ||
|
|
1188aeafc4 | ||
|
|
17aafc4506 | ||
|
|
0dcde13384 | ||
|
|
3fadc37802 | ||
|
|
2006d2ee77 | ||
|
|
149fae7008 | ||
|
|
a7a56fa2a2 | ||
|
|
84ac76fa2b | ||
|
|
69b8ec4e0b | ||
|
|
4b67c3cac6 | ||
|
|
c3ea7a1e5e | ||
|
|
468c755abd | ||
|
|
fc96be4924 | ||
|
|
7ca48f376f | ||
|
|
8c7e6611e0 | ||
|
|
b5bdd9352f | ||
|
|
ae02b26cf9 | ||
|
|
cc89c40751 | ||
|
|
880c487c0f | ||
|
|
45a9bcf295 | ||
|
|
ebf0d4322b | ||
|
|
015b00b8fc | ||
|
|
51511461f6 | ||
|
|
aaaf52fb1e | ||
|
|
33edfd3bb3 | ||
|
|
f92dc544c4 | ||
|
|
1c2d5dd389 | ||
|
|
b40de37ccb | ||
|
|
63485a26bf | ||
|
|
fe40a3d27b | ||
|
|
2c56c9c69f | ||
|
|
d9d52d8b77 | ||
|
|
2eaafc38f6 | ||
|
|
c7c7d37f29 | ||
|
|
b6b5b6d08e | ||
|
|
f6acf6e19f | ||
|
|
46aa301f1d | ||
|
|
fd95cf6b29 | ||
|
|
83d6bb230d | ||
|
|
6c8a6bd7c0 | ||
|
|
d89f8d895d | ||
|
|
0a87323eda | ||
|
|
5595c074fe | ||
|
|
530088c77c | ||
|
|
177b8f31da | ||
|
|
4e66b2882d | ||
|
|
e63241c699 | ||
|
|
81bde5c3cd | ||
|
|
602894efdd | ||
|
|
df9a478ea1 | ||
|
|
92e0c7e9ff | ||
|
|
8c422a76f4 | ||
|
|
8ae1499122 | ||
|
|
c42818f103 | ||
|
|
601c626b03 | ||
|
|
14f8f66833 | ||
|
|
32e3a31c3e | ||
|
|
b27551897d | ||
|
|
20041294d9 | ||
|
|
163cdee60f | ||
|
|
b6bce947f1 | ||
|
|
1ebf45c533 | ||
|
|
c32f0fffb1 | ||
|
|
d87304573c | ||
|
|
86511491a6 | ||
|
|
7b53efc709 | ||
|
|
797692d70f | ||
|
|
8bdf88e5ad | ||
|
|
0c3fc7074e | ||
|
|
01d816781e | ||
|
|
93cd5f4cff | ||
|
|
a35b2d125d | ||
|
|
53a599fc03 | ||
|
|
c19fde229a | ||
|
|
7992f8fcb8 | ||
|
|
1a50145d39 | ||
|
|
eb900ddd81 | ||
|
|
ccecb0b9f4 | ||
|
|
9fb88c6700 | ||
|
|
6b7bd7156c | ||
|
|
1fabf4d2cf | ||
|
|
7eb7c598fb | ||
|
|
8b5c0c1b07 | ||
|
|
c1e7a272cc | ||
|
|
5427c27930 | ||
|
|
b5c4d2beb9 | ||
|
|
34380326c8 | ||
|
|
9227d3cc30 | ||
|
|
8da668f1ac | ||
|
|
1b7c5789fc | ||
|
|
cdeb837838 | ||
|
|
cca163c776 | ||
|
|
c54b44edf3 | ||
|
|
2691cfc0f1 | ||
|
|
b2c4b7f51c | ||
|
|
c924290b5b | ||
|
|
e46deb93c8 | ||
|
|
8776c4f8f3 | ||
|
|
e5225db006 | ||
|
|
48a30b53c8 | ||
|
|
3be24a5704 | ||
|
|
76b6e22b4d | ||
|
|
ecc5e0e2d6 | ||
|
|
aa96279ecc | ||
|
|
e0ddb331f6 | ||
|
|
85e331e49a | ||
|
|
5eedc8adb4 | ||
|
|
c64cc69eb2 | ||
|
|
6c67566767 | ||
|
|
deb3b1dc14 | ||
|
|
2e44beabc1 | ||
|
|
e2b5353fec | ||
|
|
9ae51bc3c1 | ||
|
|
7f7e2c2c52 | ||
|
|
7a33b2b3c9 | ||
|
|
68ee51f1e3 | ||
|
|
dd2962ee92 | ||
|
|
5c4570baa5 | ||
|
|
1a950e4f83 | ||
|
|
8cd6378c81 | ||
|
|
ef7613c526 | ||
|
|
a0a1eda8fc | ||
|
|
bd207aabe1 | ||
|
|
4dbed5ff5b | ||
|
|
6eadf786f5 | ||
|
|
9e607ebb30 | ||
|
|
30f6ae4253 | ||
|
|
c826305060 | ||
|
|
db8247d701 | ||
|
|
adb46a95a6 | ||
|
|
48e5a1fa75 | ||
|
|
2fb041c6de | ||
|
|
7374ef6a73 | ||
|
|
bd2aec48ed | ||
|
|
6dc6b9266a | ||
|
|
5540282dcb | ||
|
|
67256194a0 | ||
|
|
5b0e123c10 | ||
|
|
bb96fdc9dc | ||
|
|
6ed1c643e7 | ||
|
|
0fcb43ea90 | ||
|
|
133e881ce0 | ||
|
|
45823fcede | ||
|
|
18c90a7a17 | ||
|
|
9da8e5f6ac | ||
|
|
3792b69a38 | ||
|
|
a2ad68e7e6 | ||
|
|
1b17c5c9d8 | ||
|
|
94e8f29d19 | ||
|
|
de8a7dfef8 | ||
|
|
2b09308224 | ||
|
|
5f55484fa9 | ||
|
|
e29da39eaf | ||
|
|
f4c7aac5b8 | ||
|
|
b749f5d772 | ||
|
|
2ece2cfc90 | ||
|
|
28edd197c2 | ||
|
|
fc5921a521 | ||
|
|
809e0fa0a9 | ||
|
|
dae663d856 | ||
|
|
6a247d4c43 | ||
|
|
92e5b4d415 | ||
|
|
9a64e0d271 | ||
|
|
b6a290d061 | ||
|
|
96139b2dad | ||
|
|
8a2d13187c | ||
|
|
813755b879 | ||
|
|
74b91cb3f3 | ||
|
|
d39a8a049a | ||
|
|
35aa02c645 | ||
|
|
fd0cde69d8 | ||
|
|
0f6d06d779 | ||
|
|
c277b19ee8 | ||
|
|
5736b3b684 | ||
|
|
6691e7cc9e | ||
|
|
a7f73576a9 | ||
|
|
7fc44c91b8 | ||
|
|
bc42a34e9a | ||
|
|
f53a89ff88 | ||
|
|
626c18f4c7 | ||
|
|
2d044b8032 | ||
|
|
57de4129da | ||
|
|
5ae63b301f | ||
|
|
4b92288a27 | ||
|
|
45faeb90a7 | ||
|
|
51abaf0fc0 | ||
|
|
5a03922934 | ||
|
|
33673fb37a | ||
|
|
228be4f8b8 | ||
|
|
643d03575a | ||
|
|
aa8948d5cf | ||
|
|
50dc4b0492 | ||
|
|
125d5e6199 | ||
|
|
4ff5a7169f | ||
|
|
cee82417db | ||
|
|
f4b1b11e10 | ||
|
|
e7dd7047b5 | ||
|
|
b6426ade32 | ||
|
|
790cb0205c | ||
|
|
046af44065 | ||
|
|
d36e9c48a4 | ||
|
|
0f028f38f6 | ||
|
|
feee17ad02 | ||
|
|
7b7ec434df | ||
|
|
176efb7623 | ||
|
|
b51792fe0e | ||
|
|
050d9a9707 | ||
|
|
03e52f49e8 | ||
|
|
30913b2cc4 | ||
|
|
7809518612 | ||
|
|
bbed46d3eb | ||
|
|
4a1f3cbd3f | ||
|
|
bcd869d520 | ||
|
|
2e6eeafabd | ||
|
|
52371f5016 | ||
|
|
d84c64fa0e | ||
|
|
a4aaa30e93 | ||
|
|
97afd95451 | ||
|
|
29ff44e23e | ||
|
|
9c525009d7 | ||
|
|
9c294f7815 | ||
|
|
766bf31737 | ||
|
|
9523575721 | ||
|
|
406722b5ef | ||
|
|
5258a75382 | ||
|
|
966af37f89 | ||
|
|
22a5a8de6d | ||
|
|
d3b680b6db | ||
|
|
d49ceacb7d | ||
|
|
8cc92c59a6 | ||
|
|
77c9082deb | ||
|
|
727d9380cb | ||
|
|
7a13564a8b | ||
|
|
23348a21a6 | ||
|
|
0b68af123c | ||
|
|
4b1ff48219 | ||
|
|
beaba1ca15 | ||
|
|
315b87d391 | ||
|
|
4adb3324ef | ||
|
|
08f0e86d76 | ||
|
|
8653d6d5d5 | ||
|
|
194bf605c2 | ||
|
|
1e4d6a4161 | ||
|
|
e48468a9e7 | ||
|
|
ea0fb3c0fc | ||
|
|
b48a52f9a0 | ||
|
|
913c00c74d | ||
|
|
8936d09951 | ||
|
|
599a9d1e7b | ||
|
|
5fb2e62216 | ||
|
|
b45a6ca810 | ||
|
|
a4d0a4fc14 | ||
|
|
491ee81889 | ||
|
|
75c2503abd | ||
|
|
e2b24e43a2 | ||
|
|
d0dbb20805 | ||
|
|
cf8b5473c7 | ||
|
|
181bc26b29 | ||
|
|
0513898b9d | ||
|
|
2048f0d6f5 | ||
|
|
f5437078e1 | ||
|
|
13f99cbf1c | ||
|
|
491f213fbd | ||
|
|
941d4e6172 | ||
|
|
b01a300c31 | ||
|
|
f28f55c41e | ||
|
|
31f672275e | ||
|
|
eee9768cd8 | ||
|
|
c395b42d2c | ||
|
|
edd027edd4 | ||
|
|
a0f69cec92 | ||
|
|
24a3ffa234 | ||
|
|
48fd68115e | ||
|
|
6f08e78456 | ||
|
|
67d06687a0 | ||
|
|
95c33d3c04 | ||
|
|
08f61f667d | ||
|
|
cf9c68846c | ||
|
|
a54799127c | ||
|
|
c6e26ddea4 | ||
|
|
f136a4e0d6 | ||
|
|
3c16c85a75 | ||
|
|
0c509fe57e | ||
|
|
996edff6d1 | ||
|
|
f2cfaee6fe | ||
|
|
dc36a636af | ||
|
|
6fc3f7c3f4 | ||
|
|
f29e70883c | ||
|
|
e50c97c29b | ||
|
|
7e3bb3aec2 | ||
|
|
92c9d1f2c9 | ||
|
|
669d9cc790 | ||
|
|
1c27f7b29a | ||
|
|
cc5fe121bf | ||
|
|
15e05d96ad | ||
|
|
bab03bd8af | ||
|
|
1755069df2 | ||
|
|
3b700c8715 | ||
|
|
077f46b777 | ||
|
|
8fc40da739 | ||
|
|
8440181001 | ||
|
|
c7bf143450 | ||
|
|
63299b15b3 | ||
|
|
3eb9bc8ef5 | ||
|
|
1b3ccb85aa | ||
|
|
2e5e94cb7f | ||
|
|
adfe8a8311 | ||
|
|
b3f781a648 | ||
|
|
86cbe3d616 | ||
|
|
9bd8e8b3c7 | ||
|
|
e226772a72 | ||
|
|
e363c54057 | ||
|
|
eb274d25d9 | ||
|
|
dada133784 | ||
|
|
d8c8178f92 | ||
|
|
27d7964bb1 | ||
|
|
e6460534e3 | ||
|
|
4834dfd280 | ||
|
|
7f2c14ecf8 | ||
|
|
027d77468e | ||
|
|
689235af16 | ||
|
|
4834b63b35 | ||
|
|
2dee4072a3 | ||
|
|
e7be2ddf8d | ||
|
|
10b8471e3c | ||
|
|
dd14888f5f | ||
|
|
87d520f0b1 | ||
|
|
5070b2d785 | ||
|
|
afb97961e3 | ||
|
|
dc12e902b1 | ||
|
|
2b7b717664 | ||
|
|
d738089e3e | ||
|
|
bcf8d0617e | ||
|
|
da4c7791fe | ||
|
|
53d8cee6f8 | ||
|
|
cd94878374 | ||
|
|
0ff58108e4 | ||
|
|
1bc9b9c585 | ||
|
|
10e34aa47a | ||
|
|
9d766af025 | ||
|
|
2fba71fcdb | ||
|
|
63c437b986 | ||
|
|
3199120abe | ||
|
|
478466168a | ||
|
|
cf7d3ae584 | ||
|
|
051d47eb5f | ||
|
|
40ed9c7f6a | ||
|
|
09f6bc3166 | ||
|
|
9952fcbd7c | ||
|
|
d4cdeca946 | ||
|
|
a6f798e505 | ||
|
|
f498dc0971 | ||
|
|
08e9d0e28b | ||
|
|
19ad704216 | ||
|
|
91e145338f | ||
|
|
a3f600e25f | ||
|
|
868763dfa9 | ||
|
|
38f502299a | ||
|
|
6dc5577319 | ||
|
|
2709694b7b | ||
|
|
a7bfe82af9 | ||
|
|
098b773c11 | ||
|
|
a7309481f4 | ||
|
|
bde186d987 | ||
|
|
349d3a08cb | ||
|
|
f450a14ef7 | ||
|
|
ef2820f614 | ||
|
|
05ef8dfaac | ||
|
|
e567dc39c8 | ||
|
|
2d5d0e5c1d | ||
|
|
df3ac98ce3 | ||
|
|
7622973452 | ||
|
|
8ff5e736cd | ||
|
|
7afc6892b1 | ||
|
|
05512f6720 | ||
|
|
5bff920bf8 | ||
|
|
3469773b32 | ||
|
|
e83ecfd3f9 | ||
|
|
0eb31212e9 | ||
|
|
8fbd89b215 | ||
|
|
cd57c17d8e | ||
|
|
27b8272fad | ||
|
|
1d46559201 | ||
|
|
e923c60bee | ||
|
|
52fc93180b | ||
|
|
2146619845 | ||
|
|
cbdced9979 | ||
|
|
bdbed70436 | ||
|
|
1ec6b56848 | ||
|
|
62519f2b62 | ||
|
|
c40c5b95aa | ||
|
|
572c7a8fe6 | ||
|
|
c7f68a74e3 | ||
|
|
b1ad3bcfc7 | ||
|
|
4967dad08c | ||
|
|
df96abe74c | ||
|
|
7dfdbe0b17 | ||
|
|
8488811b80 | ||
|
|
e09c548edf | ||
|
|
c2994ba24f | ||
|
|
c547823c53 | ||
|
|
e7b9d33dc9 | ||
|
|
b6d15b42f2 | ||
|
|
8a3651588a | ||
|
|
56bd57c543 | ||
|
|
ff303d71b6 | ||
|
|
a1e37d7c0d | ||
|
|
3568102064 | ||
|
|
4d759f91da | ||
|
|
57e2435b4f | ||
|
|
4b24d5777d | ||
|
|
92fbc52906 | ||
|
|
05d836387e | ||
|
|
9d7531706d | ||
|
|
ece14da5cd | ||
|
|
eb39a0ea57 | ||
|
|
50ebf1605a | ||
|
|
8fe97d1675 | ||
|
|
fca7e4412c | ||
|
|
adebf3e30b | ||
|
|
31afed5b5d | ||
|
|
da813d48a0 | ||
|
|
cba43546fd | ||
|
|
989ed60994 | ||
|
|
753da37743 | ||
|
|
c2199710c2 | ||
|
|
a77c8c3f85 | ||
|
|
bf5961e8d1 | ||
|
|
05acc27530 | ||
|
|
0f4f95b3de | ||
|
|
2f0a40a63f | ||
|
|
b9d0e0b04d | ||
|
|
3d2ec5ae12 | ||
|
|
746d227acd | ||
|
|
dbdbcef58f | ||
|
|
0aad18a830 | ||
|
|
786f46dad5 | ||
|
|
1346f83b08 | ||
|
|
908116d736 | ||
|
|
2ba1a550ca | ||
|
|
600de94a47 | ||
|
|
db6d52e4af | ||
|
|
60b6de003b | ||
|
|
8baffb4ad3 | ||
|
|
9d718ec66a | ||
|
|
6eba30f02b |
@@ -1,11 +1,12 @@
|
|||||||
{
|
{
|
||||||
"name": "everything-claude-code",
|
"name": "ecc",
|
||||||
"interface": {
|
"interface": {
|
||||||
"displayName": "Everything Claude Code"
|
"displayName": "Everything Claude Code"
|
||||||
},
|
},
|
||||||
"plugins": [
|
"plugins": [
|
||||||
{
|
{
|
||||||
"name": "everything-claude-code",
|
"name": "ecc",
|
||||||
|
"version": "2.0.0-rc.1",
|
||||||
"source": {
|
"source": {
|
||||||
"source": "local",
|
"source": "local",
|
||||||
"path": "../.."
|
"path": "../.."
|
||||||
|
|||||||
152
.agents/skills/agent-introspection-debugging/SKILL.md
Normal file
152
.agents/skills/agent-introspection-debugging/SKILL.md
Normal file
@@ -0,0 +1,152 @@
|
|||||||
|
---
|
||||||
|
name: agent-introspection-debugging
|
||||||
|
description: Structured self-debugging workflow for AI agent failures using capture, diagnosis, contained recovery, and introspection reports.
|
||||||
|
---
|
||||||
|
|
||||||
|
# Agent Introspection Debugging
|
||||||
|
|
||||||
|
Use this skill when an agent run is failing repeatedly, consuming tokens without progress, looping on the same tools, or drifting away from the intended task.
|
||||||
|
|
||||||
|
This is a workflow skill, not a hidden runtime. It teaches the agent to debug itself systematically before escalating to a human.
|
||||||
|
|
||||||
|
## When to Activate
|
||||||
|
|
||||||
|
- Maximum tool call / loop-limit failures
|
||||||
|
- Repeated retries with no forward progress
|
||||||
|
- Context growth or prompt drift that starts degrading output quality
|
||||||
|
- File-system or environment state mismatch between expectation and reality
|
||||||
|
- Tool failures that are likely recoverable with diagnosis and a smaller corrective action
|
||||||
|
|
||||||
|
## Scope Boundaries
|
||||||
|
|
||||||
|
Activate this skill for:
|
||||||
|
- capturing failure state before retrying blindly
|
||||||
|
- diagnosing common agent-specific failure patterns
|
||||||
|
- applying contained recovery actions
|
||||||
|
- producing a structured human-readable debug report
|
||||||
|
|
||||||
|
Do not use this skill as the primary source for:
|
||||||
|
- feature verification after code changes; use `verification-loop`
|
||||||
|
- framework-specific debugging when a narrower ECC skill already exists
|
||||||
|
- runtime promises the current harness cannot enforce automatically
|
||||||
|
|
||||||
|
## Four-Phase Loop
|
||||||
|
|
||||||
|
### Phase 1: Failure Capture
|
||||||
|
|
||||||
|
Before trying to recover, record the failure precisely.
|
||||||
|
|
||||||
|
Capture:
|
||||||
|
- error type, message, and stack trace when available
|
||||||
|
- last meaningful tool call sequence
|
||||||
|
- what the agent was trying to do
|
||||||
|
- current context pressure: repeated prompts, oversized pasted logs, duplicated plans, or runaway notes
|
||||||
|
- current environment assumptions: cwd, branch, relevant service state, expected files
|
||||||
|
|
||||||
|
Minimum capture template:
|
||||||
|
|
||||||
|
```markdown
|
||||||
|
## Failure Capture
|
||||||
|
- Session / task:
|
||||||
|
- Goal in progress:
|
||||||
|
- Error:
|
||||||
|
- Last successful step:
|
||||||
|
- Last failed tool / command:
|
||||||
|
- Repeated pattern seen:
|
||||||
|
- Environment assumptions to verify:
|
||||||
|
```
|
||||||
|
|
||||||
|
### Phase 2: Root-Cause Diagnosis
|
||||||
|
|
||||||
|
Match the failure to a known pattern before changing anything.
|
||||||
|
|
||||||
|
| Pattern | Likely Cause | Check |
|
||||||
|
| --- | --- | --- |
|
||||||
|
| Maximum tool calls / repeated same command | loop or no-exit observer path | inspect the last N tool calls for repetition |
|
||||||
|
| Context overflow / degraded reasoning | unbounded notes, repeated plans, oversized logs | inspect recent context for duplication and low-signal bulk |
|
||||||
|
| `ECONNREFUSED` / timeout | service unavailable or wrong port | verify service health, URL, and port assumptions |
|
||||||
|
| `429` / quota exhaustion | retry storm or missing backoff | count repeated calls and inspect retry spacing |
|
||||||
|
| file missing after write / stale diff | race, wrong cwd, or branch drift | re-check path, cwd, git status, and actual file existence |
|
||||||
|
| tests still failing after “fix” | wrong hypothesis | isolate the exact failing test and re-derive the bug |
|
||||||
|
|
||||||
|
Diagnosis questions:
|
||||||
|
- is this a logic failure, state failure, environment failure, or policy failure?
|
||||||
|
- did the agent lose the real objective and start optimizing the wrong subtask?
|
||||||
|
- is the failure deterministic or transient?
|
||||||
|
- what is the smallest reversible action that would validate the diagnosis?
|
||||||
|
|
||||||
|
### Phase 3: Contained Recovery
|
||||||
|
|
||||||
|
Recover with the smallest action that changes the diagnosis surface.
|
||||||
|
|
||||||
|
Safe recovery actions:
|
||||||
|
- stop repeated retries and restate the hypothesis
|
||||||
|
- trim low-signal context and keep only the active goal, blockers, and evidence
|
||||||
|
- re-check the actual filesystem / branch / process state
|
||||||
|
- narrow the task to one failing command, one file, or one test
|
||||||
|
- switch from speculative reasoning to direct observation
|
||||||
|
- escalate to a human when the failure is high-risk or externally blocked
|
||||||
|
|
||||||
|
Do not claim unsupported auto-healing actions like “reset agent state” or “update harness config” unless you are actually doing them through real tools in the current environment.
|
||||||
|
|
||||||
|
Contained recovery checklist:
|
||||||
|
|
||||||
|
```markdown
|
||||||
|
## Recovery Action
|
||||||
|
- Diagnosis chosen:
|
||||||
|
- Smallest action taken:
|
||||||
|
- Why this is safe:
|
||||||
|
- What evidence would prove the fix worked:
|
||||||
|
```
|
||||||
|
|
||||||
|
### Phase 4: Introspection Report
|
||||||
|
|
||||||
|
End with a report that makes the recovery legible to the next agent or human.
|
||||||
|
|
||||||
|
```markdown
|
||||||
|
## Agent Self-Debug Report
|
||||||
|
- Session / task:
|
||||||
|
- Failure:
|
||||||
|
- Root cause:
|
||||||
|
- Recovery action:
|
||||||
|
- Result: success | partial | blocked
|
||||||
|
- Token / time burn risk:
|
||||||
|
- Follow-up needed:
|
||||||
|
- Preventive change to encode later:
|
||||||
|
```
|
||||||
|
|
||||||
|
## Recovery Heuristics
|
||||||
|
|
||||||
|
Prefer these interventions in order:
|
||||||
|
|
||||||
|
1. Restate the real objective in one sentence.
|
||||||
|
2. Verify the world state instead of trusting memory.
|
||||||
|
3. Shrink the failing scope.
|
||||||
|
4. Run one discriminating check.
|
||||||
|
5. Only then retry.
|
||||||
|
|
||||||
|
Bad pattern:
|
||||||
|
- retrying the same action three times with slightly different wording
|
||||||
|
|
||||||
|
Good pattern:
|
||||||
|
- capture failure
|
||||||
|
- classify the pattern
|
||||||
|
- run one direct check
|
||||||
|
- change the plan only if the check supports it
|
||||||
|
|
||||||
|
## Integration with ECC
|
||||||
|
|
||||||
|
- Use `verification-loop` after recovery if code was changed.
|
||||||
|
- Use `continuous-learning-v2` when the failure pattern is worth turning into an instinct or later skill.
|
||||||
|
- Use `council` when the issue is not technical failure but decision ambiguity.
|
||||||
|
- Use `workspace-surface-audit` if the failure came from conflicting local state or repo drift.
|
||||||
|
|
||||||
|
## Output Standard
|
||||||
|
|
||||||
|
When this skill is active, do not end with “I fixed it” alone.
|
||||||
|
|
||||||
|
Always provide:
|
||||||
|
- the failure pattern
|
||||||
|
- the root-cause hypothesis
|
||||||
|
- the recovery action
|
||||||
|
- the evidence that the situation is now better or still blocked
|
||||||
@@ -0,0 +1,7 @@
|
|||||||
|
interface:
|
||||||
|
display_name: "Agent Introspection Debugging"
|
||||||
|
short_description: "Structured self-debugging for AI agent failures"
|
||||||
|
brand_color: "#0EA5E9"
|
||||||
|
default_prompt: "Use $agent-introspection-debugging to diagnose and recover from an AI agent failure."
|
||||||
|
policy:
|
||||||
|
allow_implicit_invocation: true
|
||||||
214
.agents/skills/agent-sort/SKILL.md
Normal file
214
.agents/skills/agent-sort/SKILL.md
Normal file
@@ -0,0 +1,214 @@
|
|||||||
|
---
|
||||||
|
name: agent-sort
|
||||||
|
description: Build an evidence-backed ECC install plan for a specific repo by sorting skills, commands, rules, hooks, and extras into DAILY vs LIBRARY buckets using parallel repo-aware review passes. Use when ECC should be trimmed to what a project actually needs instead of loading the full bundle.
|
||||||
|
---
|
||||||
|
|
||||||
|
# Agent Sort
|
||||||
|
|
||||||
|
Use this skill when a repo needs a project-specific ECC surface instead of the default full install.
|
||||||
|
|
||||||
|
The goal is not to guess what "feels useful." The goal is to classify ECC components with evidence from the actual codebase.
|
||||||
|
|
||||||
|
## When to Use
|
||||||
|
|
||||||
|
- A project only needs a subset of ECC and full installs are too noisy
|
||||||
|
- The repo stack is clear, but nobody wants to hand-curate skills one by one
|
||||||
|
- A team wants a repeatable install decision backed by grep evidence instead of opinion
|
||||||
|
- You need to separate always-loaded daily workflow surfaces from searchable library/reference surfaces
|
||||||
|
- A repo has drifted into the wrong language, rule, or hook set and needs cleanup
|
||||||
|
|
||||||
|
## Non-Negotiable Rules
|
||||||
|
|
||||||
|
- Use the current repository as the source of truth, not generic preferences
|
||||||
|
- Every DAILY decision must cite concrete repo evidence
|
||||||
|
- LIBRARY does not mean "delete"; it means "keep accessible without loading by default"
|
||||||
|
- Do not install hooks, rules, or scripts that the current repo cannot use
|
||||||
|
- Prefer ECC-native surfaces; do not introduce a second install system
|
||||||
|
|
||||||
|
## Outputs
|
||||||
|
|
||||||
|
Produce these artifacts in order:
|
||||||
|
|
||||||
|
1. DAILY inventory
|
||||||
|
2. LIBRARY inventory
|
||||||
|
3. install plan
|
||||||
|
4. verification report
|
||||||
|
5. optional `skill-library` router if the project wants one
|
||||||
|
|
||||||
|
## Classification Model
|
||||||
|
|
||||||
|
Use two buckets only:
|
||||||
|
|
||||||
|
- `DAILY`
|
||||||
|
- should load every session for this repo
|
||||||
|
- strongly matched to the repo's language, framework, workflow, or operator surface
|
||||||
|
- `LIBRARY`
|
||||||
|
- useful to retain, but not worth loading by default
|
||||||
|
- should remain reachable through search, router skill, or selective manual use
|
||||||
|
|
||||||
|
## Evidence Sources
|
||||||
|
|
||||||
|
Use repo-local evidence before making any classification:
|
||||||
|
|
||||||
|
- file extensions
|
||||||
|
- package managers and lockfiles
|
||||||
|
- framework configs
|
||||||
|
- CI and hook configs
|
||||||
|
- build/test scripts
|
||||||
|
- imports and dependency manifests
|
||||||
|
- repo docs that explicitly describe the stack
|
||||||
|
|
||||||
|
Useful commands include:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
rg --files
|
||||||
|
rg -n "typescript|react|next|supabase|django|spring|flutter|swift"
|
||||||
|
cat package.json
|
||||||
|
cat pyproject.toml
|
||||||
|
cat Cargo.toml
|
||||||
|
cat pubspec.yaml
|
||||||
|
cat go.mod
|
||||||
|
```
|
||||||
|
|
||||||
|
## Parallel Review Passes
|
||||||
|
|
||||||
|
If parallel subagents are available, split the review into these passes:
|
||||||
|
|
||||||
|
1. Agents
|
||||||
|
- classify `agents/*`
|
||||||
|
2. Skills
|
||||||
|
- classify `skills/*`
|
||||||
|
3. Commands
|
||||||
|
- classify `commands/*`
|
||||||
|
4. Rules
|
||||||
|
- classify `rules/*`
|
||||||
|
5. Hooks and scripts
|
||||||
|
- classify hook surfaces, MCP health checks, helper scripts, and OS compatibility
|
||||||
|
6. Extras
|
||||||
|
- classify contexts, examples, MCP configs, templates, and guidance docs
|
||||||
|
|
||||||
|
If subagents are not available, run the same passes sequentially.
|
||||||
|
|
||||||
|
## Core Workflow
|
||||||
|
|
||||||
|
### 1. Read the repo
|
||||||
|
|
||||||
|
Establish the real stack before classifying anything:
|
||||||
|
|
||||||
|
- languages in use
|
||||||
|
- frameworks in use
|
||||||
|
- primary package manager
|
||||||
|
- test stack
|
||||||
|
- lint/format stack
|
||||||
|
- deployment/runtime surface
|
||||||
|
- operator integrations already present
|
||||||
|
|
||||||
|
### 2. Build the evidence table
|
||||||
|
|
||||||
|
For every candidate surface, record:
|
||||||
|
|
||||||
|
- component path
|
||||||
|
- component type
|
||||||
|
- proposed bucket
|
||||||
|
- repo evidence
|
||||||
|
- short justification
|
||||||
|
|
||||||
|
Use this format:
|
||||||
|
|
||||||
|
```text
|
||||||
|
skills/frontend-patterns | skill | DAILY | 84 .tsx files, next.config.ts present | core frontend stack
|
||||||
|
skills/django-patterns | skill | LIBRARY | no .py files, no pyproject.toml | not active in this repo
|
||||||
|
rules/typescript/* | rules | DAILY | package.json + tsconfig.json | active TS repo
|
||||||
|
rules/python/* | rules | LIBRARY | zero Python source files | keep accessible only
|
||||||
|
```
|
||||||
|
|
||||||
|
### 3. Decide DAILY vs LIBRARY
|
||||||
|
|
||||||
|
Promote to `DAILY` when:
|
||||||
|
|
||||||
|
- the repo clearly uses the matching stack
|
||||||
|
- the component is general enough to help every session
|
||||||
|
- the repo already depends on the corresponding runtime or workflow
|
||||||
|
|
||||||
|
Demote to `LIBRARY` when:
|
||||||
|
|
||||||
|
- the component is off-stack
|
||||||
|
- the repo might need it later, but not every day
|
||||||
|
- it adds context overhead without immediate relevance
|
||||||
|
|
||||||
|
### 4. Build the install plan
|
||||||
|
|
||||||
|
Translate the classification into action:
|
||||||
|
|
||||||
|
- DAILY skills -> install or keep in `.claude/skills/`
|
||||||
|
- DAILY commands -> keep as explicit shims only if still useful
|
||||||
|
- DAILY rules -> install only matching language sets
|
||||||
|
- DAILY hooks/scripts -> keep only compatible ones
|
||||||
|
- LIBRARY surfaces -> keep accessible through search or `skill-library`
|
||||||
|
|
||||||
|
If the repo already uses selective installs, update that plan instead of creating another system.
|
||||||
|
|
||||||
|
### 5. Create the optional library router
|
||||||
|
|
||||||
|
If the project wants a searchable library surface, create:
|
||||||
|
|
||||||
|
- `.claude/skills/skill-library/SKILL.md`
|
||||||
|
|
||||||
|
That router should contain:
|
||||||
|
|
||||||
|
- a short explanation of DAILY vs LIBRARY
|
||||||
|
- grouped trigger keywords
|
||||||
|
- where the library references live
|
||||||
|
|
||||||
|
Do not duplicate every skill body inside the router.
|
||||||
|
|
||||||
|
### 6. Verify the result
|
||||||
|
|
||||||
|
After the plan is applied, verify:
|
||||||
|
|
||||||
|
- every DAILY file exists where expected
|
||||||
|
- stale language rules were not left active
|
||||||
|
- incompatible hooks were not installed
|
||||||
|
- the resulting install actually matches the repo stack
|
||||||
|
|
||||||
|
Return a compact report with:
|
||||||
|
|
||||||
|
- DAILY count
|
||||||
|
- LIBRARY count
|
||||||
|
- removed stale surfaces
|
||||||
|
- open questions
|
||||||
|
|
||||||
|
## Handoffs
|
||||||
|
|
||||||
|
If the next step is interactive installation or repair, hand off to:
|
||||||
|
|
||||||
|
- `configure-ecc`
|
||||||
|
|
||||||
|
If the next step is overlap cleanup or catalog review, hand off to:
|
||||||
|
|
||||||
|
- `skill-stocktake`
|
||||||
|
|
||||||
|
If the next step is broader context trimming, hand off to:
|
||||||
|
|
||||||
|
- `strategic-compact`
|
||||||
|
|
||||||
|
## Output Format
|
||||||
|
|
||||||
|
Return the result in this order:
|
||||||
|
|
||||||
|
```text
|
||||||
|
STACK
|
||||||
|
- language/framework/runtime summary
|
||||||
|
|
||||||
|
DAILY
|
||||||
|
- always-loaded items with evidence
|
||||||
|
|
||||||
|
LIBRARY
|
||||||
|
- searchable/reference items with evidence
|
||||||
|
|
||||||
|
INSTALL PLAN
|
||||||
|
- what should be installed, removed, or routed
|
||||||
|
|
||||||
|
VERIFICATION
|
||||||
|
- checks run and remaining gaps
|
||||||
|
```
|
||||||
7
.agents/skills/agent-sort/agents/openai.yaml
Normal file
7
.agents/skills/agent-sort/agents/openai.yaml
Normal file
@@ -0,0 +1,7 @@
|
|||||||
|
interface:
|
||||||
|
display_name: "Agent Sort"
|
||||||
|
short_description: "Evidence-backed ECC install planning"
|
||||||
|
brand_color: "#0EA5E9"
|
||||||
|
default_prompt: "Use $agent-sort to build an evidence-backed ECC install plan."
|
||||||
|
policy:
|
||||||
|
allow_implicit_invocation: true
|
||||||
@@ -1,7 +1,6 @@
|
|||||||
---
|
---
|
||||||
name: api-design
|
name: api-design
|
||||||
description: REST API design patterns including resource naming, status codes, pagination, filtering, error responses, versioning, and rate limiting for production APIs.
|
description: REST API design patterns including resource naming, status codes, pagination, filtering, error responses, versioning, and rate limiting for production APIs.
|
||||||
origin: ECC
|
|
||||||
---
|
---
|
||||||
|
|
||||||
# API Design Patterns
|
# API Design Patterns
|
||||||
|
|||||||
@@ -2,6 +2,6 @@ interface:
|
|||||||
display_name: "API Design"
|
display_name: "API Design"
|
||||||
short_description: "REST API design patterns and best practices"
|
short_description: "REST API design patterns and best practices"
|
||||||
brand_color: "#F97316"
|
brand_color: "#F97316"
|
||||||
default_prompt: "Design REST API: resources, status codes, pagination"
|
default_prompt: "Use $api-design to design production REST API resources and responses."
|
||||||
policy:
|
policy:
|
||||||
allow_implicit_invocation: true
|
allow_implicit_invocation: true
|
||||||
|
|||||||
@@ -1,7 +1,6 @@
|
|||||||
---
|
---
|
||||||
name: article-writing
|
name: article-writing
|
||||||
description: Write articles, guides, blog posts, tutorials, newsletter issues, and other long-form content in a distinctive voice derived from supplied examples or brand guidance. Use when the user wants polished written content longer than a paragraph, especially when voice consistency, structure, and credibility matter.
|
description: Write articles, guides, blog posts, tutorials, newsletter issues, and other long-form content in a distinctive voice derived from supplied examples or brand guidance. Use when the user wants polished written content longer than a paragraph, especially when voice consistency, structure, and credibility matter.
|
||||||
origin: ECC
|
|
||||||
---
|
---
|
||||||
|
|
||||||
# Article Writing
|
# Article Writing
|
||||||
|
|||||||
@@ -1,7 +1,7 @@
|
|||||||
interface:
|
interface:
|
||||||
display_name: "Article Writing"
|
display_name: "Article Writing"
|
||||||
short_description: "Write long-form content in a supplied voice without sounding templated"
|
short_description: "Long-form content in a supplied voice"
|
||||||
brand_color: "#B45309"
|
brand_color: "#B45309"
|
||||||
default_prompt: "Draft a sharp long-form article from these notes and examples"
|
default_prompt: "Use $article-writing to draft polished long-form content in the supplied voice."
|
||||||
policy:
|
policy:
|
||||||
allow_implicit_invocation: true
|
allow_implicit_invocation: true
|
||||||
|
|||||||
@@ -1,7 +1,6 @@
|
|||||||
---
|
---
|
||||||
name: backend-patterns
|
name: backend-patterns
|
||||||
description: Backend architecture patterns, API design, database optimization, and server-side best practices for Node.js, Express, and Next.js API routes.
|
description: Backend architecture patterns, API design, database optimization, and server-side best practices for Node.js, Express, and Next.js API routes.
|
||||||
origin: ECC
|
|
||||||
---
|
---
|
||||||
|
|
||||||
# Backend Development Patterns
|
# Backend Development Patterns
|
||||||
|
|||||||
@@ -1,7 +1,7 @@
|
|||||||
interface:
|
interface:
|
||||||
display_name: "Backend Patterns"
|
display_name: "Backend Patterns"
|
||||||
short_description: "API design, database, and server-side patterns"
|
short_description: "API, database, and server-side patterns"
|
||||||
brand_color: "#F59E0B"
|
brand_color: "#F59E0B"
|
||||||
default_prompt: "Apply backend patterns: API design, repository, caching"
|
default_prompt: "Use $backend-patterns to apply backend architecture and API patterns."
|
||||||
policy:
|
policy:
|
||||||
allow_implicit_invocation: true
|
allow_implicit_invocation: true
|
||||||
|
|||||||
@@ -1,7 +1,6 @@
|
|||||||
---
|
---
|
||||||
name: brand-voice
|
name: brand-voice
|
||||||
description: Build a source-derived writing style profile from real posts, essays, launch notes, docs, or site copy, then reuse that profile across content, outreach, and social workflows. Use when the user wants voice consistency without generic AI writing tropes.
|
description: Build a source-derived writing style profile from real posts, essays, launch notes, docs, or site copy, then reuse that profile across content, outreach, and social workflows. Use when the user wants voice consistency without generic AI writing tropes.
|
||||||
origin: ECC
|
|
||||||
---
|
---
|
||||||
|
|
||||||
# Brand Voice
|
# Brand Voice
|
||||||
|
|||||||
7
.agents/skills/brand-voice/agents/openai.yaml
Normal file
7
.agents/skills/brand-voice/agents/openai.yaml
Normal file
@@ -0,0 +1,7 @@
|
|||||||
|
interface:
|
||||||
|
display_name: "Brand Voice"
|
||||||
|
short_description: "Source-derived writing style profiles"
|
||||||
|
brand_color: "#0EA5E9"
|
||||||
|
default_prompt: "Use $brand-voice to derive and reuse a source-grounded writing style."
|
||||||
|
policy:
|
||||||
|
allow_implicit_invocation: true
|
||||||
@@ -1,7 +1,6 @@
|
|||||||
---
|
---
|
||||||
name: bun-runtime
|
name: bun-runtime
|
||||||
description: Bun as runtime, package manager, bundler, and test runner. When to choose Bun vs Node, migration notes, and Vercel support.
|
description: Bun as runtime, package manager, bundler, and test runner. When to choose Bun vs Node, migration notes, and Vercel support.
|
||||||
origin: ECC
|
|
||||||
---
|
---
|
||||||
|
|
||||||
# Bun Runtime
|
# Bun Runtime
|
||||||
|
|||||||
@@ -1,7 +1,7 @@
|
|||||||
interface:
|
interface:
|
||||||
display_name: "Bun Runtime"
|
display_name: "Bun Runtime"
|
||||||
short_description: "Bun as runtime, package manager, bundler, and test runner"
|
short_description: "Bun runtime, package manager, and test runner"
|
||||||
brand_color: "#FBF0DF"
|
brand_color: "#FBF0DF"
|
||||||
default_prompt: "Use Bun for scripts, install, or run"
|
default_prompt: "Use $bun-runtime to choose and apply Bun runtime workflows."
|
||||||
policy:
|
policy:
|
||||||
allow_implicit_invocation: true
|
allow_implicit_invocation: true
|
||||||
|
|||||||
@@ -1,337 +0,0 @@
|
|||||||
---
|
|
||||||
name: claude-api
|
|
||||||
description: Anthropic Claude API patterns for Python and TypeScript. Covers Messages API, streaming, tool use, vision, extended thinking, batches, prompt caching, and Claude Agent SDK. Use when building applications with the Claude API or Anthropic SDKs.
|
|
||||||
origin: ECC
|
|
||||||
---
|
|
||||||
|
|
||||||
# Claude API
|
|
||||||
|
|
||||||
Build applications with the Anthropic Claude API and SDKs.
|
|
||||||
|
|
||||||
## When to Activate
|
|
||||||
|
|
||||||
- Building applications that call the Claude API
|
|
||||||
- Code imports `anthropic` (Python) or `@anthropic-ai/sdk` (TypeScript)
|
|
||||||
- User asks about Claude API patterns, tool use, streaming, or vision
|
|
||||||
- Implementing agent workflows with Claude Agent SDK
|
|
||||||
- Optimizing API costs, token usage, or latency
|
|
||||||
|
|
||||||
## Model Selection
|
|
||||||
|
|
||||||
| Model | ID | Best For |
|
|
||||||
|-------|-----|----------|
|
|
||||||
| Opus 4.6 | `claude-opus-4-6` | Complex reasoning, architecture, research |
|
|
||||||
| Sonnet 4.6 | `claude-sonnet-4-6` | Balanced coding, most development tasks |
|
|
||||||
| Haiku 4.5 | `claude-haiku-4-5-20251001` | Fast responses, high-volume, cost-sensitive |
|
|
||||||
|
|
||||||
Default to Sonnet 4.6 unless the task requires deep reasoning (Opus) or speed/cost optimization (Haiku).
|
|
||||||
|
|
||||||
## Python SDK
|
|
||||||
|
|
||||||
### Installation
|
|
||||||
|
|
||||||
```bash
|
|
||||||
pip install anthropic
|
|
||||||
```
|
|
||||||
|
|
||||||
### Basic Message
|
|
||||||
|
|
||||||
```python
|
|
||||||
import anthropic
|
|
||||||
|
|
||||||
client = anthropic.Anthropic() # reads ANTHROPIC_API_KEY from env
|
|
||||||
|
|
||||||
message = client.messages.create(
|
|
||||||
model="claude-sonnet-4-6",
|
|
||||||
max_tokens=1024,
|
|
||||||
messages=[
|
|
||||||
{"role": "user", "content": "Explain async/await in Python"}
|
|
||||||
]
|
|
||||||
)
|
|
||||||
print(message.content[0].text)
|
|
||||||
```
|
|
||||||
|
|
||||||
### Streaming
|
|
||||||
|
|
||||||
```python
|
|
||||||
with client.messages.stream(
|
|
||||||
model="claude-sonnet-4-6",
|
|
||||||
max_tokens=1024,
|
|
||||||
messages=[{"role": "user", "content": "Write a haiku about coding"}]
|
|
||||||
) as stream:
|
|
||||||
for text in stream.text_stream:
|
|
||||||
print(text, end="", flush=True)
|
|
||||||
```
|
|
||||||
|
|
||||||
### System Prompt
|
|
||||||
|
|
||||||
```python
|
|
||||||
message = client.messages.create(
|
|
||||||
model="claude-sonnet-4-6",
|
|
||||||
max_tokens=1024,
|
|
||||||
system="You are a senior Python developer. Be concise.",
|
|
||||||
messages=[{"role": "user", "content": "Review this function"}]
|
|
||||||
)
|
|
||||||
```
|
|
||||||
|
|
||||||
## TypeScript SDK
|
|
||||||
|
|
||||||
### Installation
|
|
||||||
|
|
||||||
```bash
|
|
||||||
npm install @anthropic-ai/sdk
|
|
||||||
```
|
|
||||||
|
|
||||||
### Basic Message
|
|
||||||
|
|
||||||
```typescript
|
|
||||||
import Anthropic from "@anthropic-ai/sdk";
|
|
||||||
|
|
||||||
const client = new Anthropic(); // reads ANTHROPIC_API_KEY from env
|
|
||||||
|
|
||||||
const message = await client.messages.create({
|
|
||||||
model: "claude-sonnet-4-6",
|
|
||||||
max_tokens: 1024,
|
|
||||||
messages: [
|
|
||||||
{ role: "user", content: "Explain async/await in TypeScript" }
|
|
||||||
],
|
|
||||||
});
|
|
||||||
console.log(message.content[0].text);
|
|
||||||
```
|
|
||||||
|
|
||||||
### Streaming
|
|
||||||
|
|
||||||
```typescript
|
|
||||||
const stream = client.messages.stream({
|
|
||||||
model: "claude-sonnet-4-6",
|
|
||||||
max_tokens: 1024,
|
|
||||||
messages: [{ role: "user", content: "Write a haiku" }],
|
|
||||||
});
|
|
||||||
|
|
||||||
for await (const event of stream) {
|
|
||||||
if (event.type === "content_block_delta" && event.delta.type === "text_delta") {
|
|
||||||
process.stdout.write(event.delta.text);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
## Tool Use
|
|
||||||
|
|
||||||
Define tools and let Claude call them:
|
|
||||||
|
|
||||||
```python
|
|
||||||
tools = [
|
|
||||||
{
|
|
||||||
"name": "get_weather",
|
|
||||||
"description": "Get current weather for a location",
|
|
||||||
"input_schema": {
|
|
||||||
"type": "object",
|
|
||||||
"properties": {
|
|
||||||
"location": {"type": "string", "description": "City name"},
|
|
||||||
"unit": {"type": "string", "enum": ["celsius", "fahrenheit"]}
|
|
||||||
},
|
|
||||||
"required": ["location"]
|
|
||||||
}
|
|
||||||
}
|
|
||||||
]
|
|
||||||
|
|
||||||
message = client.messages.create(
|
|
||||||
model="claude-sonnet-4-6",
|
|
||||||
max_tokens=1024,
|
|
||||||
tools=tools,
|
|
||||||
messages=[{"role": "user", "content": "What's the weather in SF?"}]
|
|
||||||
)
|
|
||||||
|
|
||||||
# Handle tool use response
|
|
||||||
for block in message.content:
|
|
||||||
if block.type == "tool_use":
|
|
||||||
# Execute the tool with block.input
|
|
||||||
result = get_weather(**block.input)
|
|
||||||
# Send result back
|
|
||||||
follow_up = client.messages.create(
|
|
||||||
model="claude-sonnet-4-6",
|
|
||||||
max_tokens=1024,
|
|
||||||
tools=tools,
|
|
||||||
messages=[
|
|
||||||
{"role": "user", "content": "What's the weather in SF?"},
|
|
||||||
{"role": "assistant", "content": message.content},
|
|
||||||
{"role": "user", "content": [
|
|
||||||
{"type": "tool_result", "tool_use_id": block.id, "content": str(result)}
|
|
||||||
]}
|
|
||||||
]
|
|
||||||
)
|
|
||||||
```
|
|
||||||
|
|
||||||
## Vision
|
|
||||||
|
|
||||||
Send images for analysis:
|
|
||||||
|
|
||||||
```python
|
|
||||||
import base64
|
|
||||||
|
|
||||||
with open("diagram.png", "rb") as f:
|
|
||||||
image_data = base64.standard_b64encode(f.read()).decode("utf-8")
|
|
||||||
|
|
||||||
message = client.messages.create(
|
|
||||||
model="claude-sonnet-4-6",
|
|
||||||
max_tokens=1024,
|
|
||||||
messages=[{
|
|
||||||
"role": "user",
|
|
||||||
"content": [
|
|
||||||
{"type": "image", "source": {"type": "base64", "media_type": "image/png", "data": image_data}},
|
|
||||||
{"type": "text", "text": "Describe this diagram"}
|
|
||||||
]
|
|
||||||
}]
|
|
||||||
)
|
|
||||||
```
|
|
||||||
|
|
||||||
## Extended Thinking
|
|
||||||
|
|
||||||
For complex reasoning tasks:
|
|
||||||
|
|
||||||
```python
|
|
||||||
message = client.messages.create(
|
|
||||||
model="claude-sonnet-4-6",
|
|
||||||
max_tokens=16000,
|
|
||||||
thinking={
|
|
||||||
"type": "enabled",
|
|
||||||
"budget_tokens": 10000
|
|
||||||
},
|
|
||||||
messages=[{"role": "user", "content": "Solve this math problem step by step..."}]
|
|
||||||
)
|
|
||||||
|
|
||||||
for block in message.content:
|
|
||||||
if block.type == "thinking":
|
|
||||||
print(f"Thinking: {block.thinking}")
|
|
||||||
elif block.type == "text":
|
|
||||||
print(f"Answer: {block.text}")
|
|
||||||
```
|
|
||||||
|
|
||||||
## Prompt Caching
|
|
||||||
|
|
||||||
Cache large system prompts or context to reduce costs:
|
|
||||||
|
|
||||||
```python
|
|
||||||
message = client.messages.create(
|
|
||||||
model="claude-sonnet-4-6",
|
|
||||||
max_tokens=1024,
|
|
||||||
system=[
|
|
||||||
{"type": "text", "text": large_system_prompt, "cache_control": {"type": "ephemeral"}}
|
|
||||||
],
|
|
||||||
messages=[{"role": "user", "content": "Question about the cached context"}]
|
|
||||||
)
|
|
||||||
# Check cache usage
|
|
||||||
print(f"Cache read: {message.usage.cache_read_input_tokens}")
|
|
||||||
print(f"Cache creation: {message.usage.cache_creation_input_tokens}")
|
|
||||||
```
|
|
||||||
|
|
||||||
## Batches API
|
|
||||||
|
|
||||||
Process large volumes asynchronously at 50% cost reduction:
|
|
||||||
|
|
||||||
```python
|
|
||||||
import time
|
|
||||||
|
|
||||||
batch = client.messages.batches.create(
|
|
||||||
requests=[
|
|
||||||
{
|
|
||||||
"custom_id": f"request-{i}",
|
|
||||||
"params": {
|
|
||||||
"model": "claude-sonnet-4-6",
|
|
||||||
"max_tokens": 1024,
|
|
||||||
"messages": [{"role": "user", "content": prompt}]
|
|
||||||
}
|
|
||||||
}
|
|
||||||
for i, prompt in enumerate(prompts)
|
|
||||||
]
|
|
||||||
)
|
|
||||||
|
|
||||||
# Poll for completion
|
|
||||||
while True:
|
|
||||||
status = client.messages.batches.retrieve(batch.id)
|
|
||||||
if status.processing_status == "ended":
|
|
||||||
break
|
|
||||||
time.sleep(30)
|
|
||||||
|
|
||||||
# Get results
|
|
||||||
for result in client.messages.batches.results(batch.id):
|
|
||||||
print(result.result.message.content[0].text)
|
|
||||||
```
|
|
||||||
|
|
||||||
## Claude Agent SDK
|
|
||||||
|
|
||||||
Build multi-step agents:
|
|
||||||
|
|
||||||
```python
|
|
||||||
# Note: Agent SDK API surface may change — check official docs
|
|
||||||
import anthropic
|
|
||||||
|
|
||||||
# Define tools as functions
|
|
||||||
tools = [{
|
|
||||||
"name": "search_codebase",
|
|
||||||
"description": "Search the codebase for relevant code",
|
|
||||||
"input_schema": {
|
|
||||||
"type": "object",
|
|
||||||
"properties": {"query": {"type": "string"}},
|
|
||||||
"required": ["query"]
|
|
||||||
}
|
|
||||||
}]
|
|
||||||
|
|
||||||
# Run an agentic loop with tool use
|
|
||||||
client = anthropic.Anthropic()
|
|
||||||
messages = [{"role": "user", "content": "Review the auth module for security issues"}]
|
|
||||||
|
|
||||||
while True:
|
|
||||||
response = client.messages.create(
|
|
||||||
model="claude-sonnet-4-6",
|
|
||||||
max_tokens=4096,
|
|
||||||
tools=tools,
|
|
||||||
messages=messages,
|
|
||||||
)
|
|
||||||
if response.stop_reason == "end_turn":
|
|
||||||
break
|
|
||||||
# Handle tool calls and continue the loop
|
|
||||||
messages.append({"role": "assistant", "content": response.content})
|
|
||||||
# ... execute tools and append tool_result messages
|
|
||||||
```
|
|
||||||
|
|
||||||
## Cost Optimization
|
|
||||||
|
|
||||||
| Strategy | Savings | When to Use |
|
|
||||||
|----------|---------|-------------|
|
|
||||||
| Prompt caching | Up to 90% on cached tokens | Repeated system prompts or context |
|
|
||||||
| Batches API | 50% | Non-time-sensitive bulk processing |
|
|
||||||
| Haiku instead of Sonnet | ~75% | Simple tasks, classification, extraction |
|
|
||||||
| Shorter max_tokens | Variable | When you know output will be short |
|
|
||||||
| Streaming | None (same cost) | Better UX, same price |
|
|
||||||
|
|
||||||
## Error Handling
|
|
||||||
|
|
||||||
```python
|
|
||||||
import time
|
|
||||||
|
|
||||||
from anthropic import APIError, RateLimitError, APIConnectionError
|
|
||||||
|
|
||||||
try:
|
|
||||||
message = client.messages.create(...)
|
|
||||||
except RateLimitError:
|
|
||||||
# Back off and retry
|
|
||||||
time.sleep(60)
|
|
||||||
except APIConnectionError:
|
|
||||||
# Network issue, retry with backoff
|
|
||||||
pass
|
|
||||||
except APIError as e:
|
|
||||||
print(f"API error {e.status_code}: {e.message}")
|
|
||||||
```
|
|
||||||
|
|
||||||
## Environment Setup
|
|
||||||
|
|
||||||
```bash
|
|
||||||
# Required
|
|
||||||
export ANTHROPIC_API_KEY="your-api-key-here"
|
|
||||||
|
|
||||||
# Optional: set default model
|
|
||||||
export ANTHROPIC_MODEL="claude-sonnet-4-6"
|
|
||||||
```
|
|
||||||
|
|
||||||
Never hardcode API keys. Always use environment variables.
|
|
||||||
@@ -1,7 +0,0 @@
|
|||||||
interface:
|
|
||||||
display_name: "Claude API"
|
|
||||||
short_description: "Anthropic Claude API patterns and SDKs"
|
|
||||||
brand_color: "#D97706"
|
|
||||||
default_prompt: "Build applications with the Claude API using Messages, tool use, streaming, and Agent SDK"
|
|
||||||
policy:
|
|
||||||
allow_implicit_invocation: true
|
|
||||||
@@ -1,12 +1,17 @@
|
|||||||
---
|
---
|
||||||
name: coding-standards
|
name: coding-standards
|
||||||
description: Universal coding standards, best practices, and patterns for TypeScript, JavaScript, React, and Node.js development.
|
description: Baseline cross-project coding conventions for naming, readability, immutability, and code-quality review. Use detailed frontend or backend skills for framework-specific patterns.
|
||||||
origin: ECC
|
|
||||||
---
|
---
|
||||||
|
|
||||||
# Coding Standards & Best Practices
|
# Coding Standards & Best Practices
|
||||||
|
|
||||||
Universal coding standards applicable across all projects.
|
Baseline coding conventions applicable across projects.
|
||||||
|
|
||||||
|
This skill is the shared floor, not the detailed framework playbook.
|
||||||
|
|
||||||
|
- Use `frontend-patterns` for React, state, forms, rendering, and UI architecture.
|
||||||
|
- Use `backend-patterns` or `api-design` for repository/service layers, endpoint design, validation, and server-specific concerns.
|
||||||
|
- Use `rules/common/coding-style.md` when you need the shortest reusable rule layer instead of a full skill walkthrough.
|
||||||
|
|
||||||
## When to Activate
|
## When to Activate
|
||||||
|
|
||||||
@@ -17,6 +22,19 @@ Universal coding standards applicable across all projects.
|
|||||||
- Setting up linting, formatting, or type-checking rules
|
- Setting up linting, formatting, or type-checking rules
|
||||||
- Onboarding new contributors to coding conventions
|
- Onboarding new contributors to coding conventions
|
||||||
|
|
||||||
|
## Scope Boundaries
|
||||||
|
|
||||||
|
Activate this skill for:
|
||||||
|
- descriptive naming
|
||||||
|
- immutability defaults
|
||||||
|
- readability, KISS, DRY, and YAGNI enforcement
|
||||||
|
- error-handling expectations and code-smell review
|
||||||
|
|
||||||
|
Do not use this skill as the primary source for:
|
||||||
|
- React composition, hooks, or rendering patterns
|
||||||
|
- backend architecture, API design, or database layering
|
||||||
|
- domain-specific framework guidance when a narrower ECC skill already exists
|
||||||
|
|
||||||
## Code Quality Principles
|
## Code Quality Principles
|
||||||
|
|
||||||
### 1. Readability First
|
### 1. Readability First
|
||||||
|
|||||||
@@ -1,7 +1,7 @@
|
|||||||
interface:
|
interface:
|
||||||
display_name: "Coding Standards"
|
display_name: "Coding Standards"
|
||||||
short_description: "Universal coding standards and best practices"
|
short_description: "Cross-project coding conventions and review"
|
||||||
brand_color: "#3B82F6"
|
brand_color: "#3B82F6"
|
||||||
default_prompt: "Apply standards: immutability, error handling, type safety"
|
default_prompt: "Use $coding-standards to review code against cross-project standards."
|
||||||
policy:
|
policy:
|
||||||
allow_implicit_invocation: true
|
allow_implicit_invocation: true
|
||||||
|
|||||||
@@ -1,7 +1,6 @@
|
|||||||
---
|
---
|
||||||
name: content-engine
|
name: content-engine
|
||||||
description: Create platform-native content systems for X, LinkedIn, TikTok, YouTube, newsletters, and repurposed multi-platform campaigns. Use when the user wants social posts, threads, scripts, content calendars, or one source asset adapted cleanly across platforms.
|
description: Create platform-native content systems for X, LinkedIn, TikTok, YouTube, newsletters, and repurposed multi-platform campaigns. Use when the user wants social posts, threads, scripts, content calendars, or one source asset adapted cleanly across platforms.
|
||||||
origin: ECC
|
|
||||||
---
|
---
|
||||||
|
|
||||||
# Content Engine
|
# Content Engine
|
||||||
|
|||||||
@@ -1,7 +1,7 @@
|
|||||||
interface:
|
interface:
|
||||||
display_name: "Content Engine"
|
display_name: "Content Engine"
|
||||||
short_description: "Turn one idea into platform-native social and content outputs"
|
short_description: "Platform-native content systems and campaigns"
|
||||||
brand_color: "#DC2626"
|
brand_color: "#DC2626"
|
||||||
default_prompt: "Turn this source asset into strong multi-platform content"
|
default_prompt: "Use $content-engine to turn source material into platform-native content."
|
||||||
policy:
|
policy:
|
||||||
allow_implicit_invocation: true
|
allow_implicit_invocation: true
|
||||||
|
|||||||
@@ -1,7 +1,6 @@
|
|||||||
---
|
---
|
||||||
name: crosspost
|
name: crosspost
|
||||||
description: Multi-platform content distribution across X, LinkedIn, Threads, and Bluesky. Adapts content per platform using content-engine patterns. Never posts identical content cross-platform. Use when the user wants to distribute content across social platforms.
|
description: Multi-platform content distribution across X, LinkedIn, Threads, and Bluesky. Adapts content per platform using content-engine patterns. Never posts identical content cross-platform. Use when the user wants to distribute content across social platforms.
|
||||||
origin: ECC
|
|
||||||
---
|
---
|
||||||
|
|
||||||
# Crosspost
|
# Crosspost
|
||||||
|
|||||||
@@ -1,7 +1,7 @@
|
|||||||
interface:
|
interface:
|
||||||
display_name: "Crosspost"
|
display_name: "Crosspost"
|
||||||
short_description: "Multi-platform content distribution with native adaptation"
|
short_description: "Multi-platform social distribution"
|
||||||
brand_color: "#EC4899"
|
brand_color: "#EC4899"
|
||||||
default_prompt: "Distribute content across X, LinkedIn, Threads, and Bluesky with platform-native adaptation"
|
default_prompt: "Use $crosspost to adapt content for multiple social platforms."
|
||||||
policy:
|
policy:
|
||||||
allow_implicit_invocation: true
|
allow_implicit_invocation: true
|
||||||
|
|||||||
@@ -1,7 +1,6 @@
|
|||||||
---
|
---
|
||||||
name: deep-research
|
name: deep-research
|
||||||
description: Multi-source deep research using firecrawl and exa MCPs. Searches the web, synthesizes findings, and delivers cited reports with source attribution. Use when the user wants thorough research on any topic with evidence and citations.
|
description: Multi-source deep research using firecrawl and exa MCPs. Searches the web, synthesizes findings, and delivers cited reports with source attribution. Use when the user wants thorough research on any topic with evidence and citations.
|
||||||
origin: ECC
|
|
||||||
---
|
---
|
||||||
|
|
||||||
# Deep Research
|
# Deep Research
|
||||||
|
|||||||
@@ -1,7 +1,7 @@
|
|||||||
interface:
|
interface:
|
||||||
display_name: "Deep Research"
|
display_name: "Deep Research"
|
||||||
short_description: "Multi-source deep research with firecrawl and exa MCPs"
|
short_description: "Multi-source cited research reports"
|
||||||
brand_color: "#6366F1"
|
brand_color: "#6366F1"
|
||||||
default_prompt: "Research the given topic using firecrawl and exa, produce a cited report"
|
default_prompt: "Use $deep-research to produce a cited multi-source research report."
|
||||||
policy:
|
policy:
|
||||||
allow_implicit_invocation: true
|
allow_implicit_invocation: true
|
||||||
|
|||||||
@@ -1,7 +1,6 @@
|
|||||||
---
|
---
|
||||||
name: dmux-workflows
|
name: dmux-workflows
|
||||||
description: Multi-agent orchestration using dmux (tmux pane manager for AI agents). Patterns for parallel agent workflows across Claude Code, Codex, OpenCode, and other harnesses. Use when running multiple agent sessions in parallel or coordinating multi-agent development workflows.
|
description: Multi-agent orchestration using dmux (tmux pane manager for AI agents). Patterns for parallel agent workflows across Claude Code, Codex, OpenCode, and other harnesses. Use when running multiple agent sessions in parallel or coordinating multi-agent development workflows.
|
||||||
origin: ECC
|
|
||||||
---
|
---
|
||||||
|
|
||||||
# dmux Workflows
|
# dmux Workflows
|
||||||
|
|||||||
@@ -2,6 +2,6 @@ interface:
|
|||||||
display_name: "dmux Workflows"
|
display_name: "dmux Workflows"
|
||||||
short_description: "Multi-agent orchestration with dmux"
|
short_description: "Multi-agent orchestration with dmux"
|
||||||
brand_color: "#14B8A6"
|
brand_color: "#14B8A6"
|
||||||
default_prompt: "Orchestrate parallel agent sessions using dmux pane manager"
|
default_prompt: "Use $dmux-workflows to orchestrate parallel agent sessions with dmux."
|
||||||
policy:
|
policy:
|
||||||
allow_implicit_invocation: true
|
allow_implicit_invocation: true
|
||||||
|
|||||||
@@ -1,7 +1,6 @@
|
|||||||
---
|
---
|
||||||
name: documentation-lookup
|
name: documentation-lookup
|
||||||
description: Use up-to-date library and framework docs via Context7 MCP instead of training data. Activates for setup questions, API references, code examples, or when the user names a framework (e.g. React, Next.js, Prisma).
|
description: Use up-to-date library and framework docs via Context7 MCP instead of training data. Activates for setup questions, API references, code examples, or when the user names a framework (e.g. React, Next.js, Prisma).
|
||||||
origin: ECC
|
|
||||||
---
|
---
|
||||||
|
|
||||||
# Documentation Lookup (Context7)
|
# Documentation Lookup (Context7)
|
||||||
|
|||||||
@@ -1,7 +1,7 @@
|
|||||||
interface:
|
interface:
|
||||||
display_name: "Documentation Lookup"
|
display_name: "Documentation Lookup"
|
||||||
short_description: "Fetch up-to-date library docs via Context7 MCP"
|
short_description: "Current library docs via Context7"
|
||||||
brand_color: "#6366F1"
|
brand_color: "#6366F1"
|
||||||
default_prompt: "Look up docs for a library or API"
|
default_prompt: "Use $documentation-lookup to fetch current library documentation via Context7."
|
||||||
policy:
|
policy:
|
||||||
allow_implicit_invocation: true
|
allow_implicit_invocation: true
|
||||||
|
|||||||
@@ -1,7 +1,6 @@
|
|||||||
---
|
---
|
||||||
name: e2e-testing
|
name: e2e-testing
|
||||||
description: Playwright E2E testing patterns, Page Object Model, configuration, CI/CD integration, artifact management, and flaky test strategies.
|
description: Playwright E2E testing patterns, Page Object Model, configuration, CI/CD integration, artifact management, and flaky test strategies.
|
||||||
origin: ECC
|
|
||||||
---
|
---
|
||||||
|
|
||||||
# E2E Testing Patterns
|
# E2E Testing Patterns
|
||||||
|
|||||||
@@ -1,7 +1,7 @@
|
|||||||
interface:
|
interface:
|
||||||
display_name: "E2E Testing"
|
display_name: "E2E Testing"
|
||||||
short_description: "Playwright end-to-end testing"
|
short_description: "Playwright E2E testing patterns"
|
||||||
brand_color: "#06B6D4"
|
brand_color: "#06B6D4"
|
||||||
default_prompt: "Generate Playwright E2E tests with Page Object Model"
|
default_prompt: "Use $e2e-testing to design Playwright end-to-end test coverage."
|
||||||
policy:
|
policy:
|
||||||
allow_implicit_invocation: true
|
allow_implicit_invocation: true
|
||||||
|
|||||||
@@ -1,8 +1,7 @@
|
|||||||
---
|
---
|
||||||
name: eval-harness
|
name: eval-harness
|
||||||
description: Formal evaluation framework for Claude Code sessions implementing eval-driven development (EDD) principles
|
description: Formal evaluation framework for Claude Code sessions implementing eval-driven development (EDD) principles
|
||||||
origin: ECC
|
allowed-tools: Read, Write, Edit, Bash, Grep, Glob
|
||||||
tools: Read, Write, Edit, Bash, Grep, Glob
|
|
||||||
---
|
---
|
||||||
|
|
||||||
# Eval Harness Skill
|
# Eval Harness Skill
|
||||||
|
|||||||
@@ -1,7 +1,7 @@
|
|||||||
interface:
|
interface:
|
||||||
display_name: "Eval Harness"
|
display_name: "Eval Harness"
|
||||||
short_description: "Eval-driven development with pass/fail criteria"
|
short_description: "Eval-driven development harnesses"
|
||||||
brand_color: "#EC4899"
|
brand_color: "#EC4899"
|
||||||
default_prompt: "Set up eval-driven development with pass/fail criteria"
|
default_prompt: "Use $eval-harness to define eval-driven development checks."
|
||||||
policy:
|
policy:
|
||||||
allow_implicit_invocation: true
|
allow_implicit_invocation: true
|
||||||
|
|||||||
@@ -1,5 +1,5 @@
|
|||||||
---
|
---
|
||||||
name: everything-claude-code-conventions
|
name: everything-claude-code
|
||||||
description: Development conventions and patterns for everything-claude-code. JavaScript project with conventional commits.
|
description: Development conventions and patterns for everything-claude-code. JavaScript project with conventional commits.
|
||||||
---
|
---
|
||||||
|
|
||||||
|
|||||||
@@ -1,6 +1,7 @@
|
|||||||
interface:
|
interface:
|
||||||
display_name: "Everything Claude Code"
|
display_name: "Everything Claude Code"
|
||||||
short_description: "Repo-specific patterns and workflows for everything-claude-code"
|
short_description: "Repo workflows for everything-claude-code"
|
||||||
default_prompt: "Use the everything-claude-code repo skill to follow existing architecture, testing, and workflow conventions."
|
brand_color: "#0EA5E9"
|
||||||
|
default_prompt: "Use $everything-claude-code to follow this repository's conventions and workflows."
|
||||||
policy:
|
policy:
|
||||||
allow_implicit_invocation: true
|
allow_implicit_invocation: true
|
||||||
@@ -1,7 +1,6 @@
|
|||||||
---
|
---
|
||||||
name: exa-search
|
name: exa-search
|
||||||
description: Neural search via Exa MCP for web, code, and company research. Use when the user needs web search, code examples, company intel, people lookup, or AI-powered deep research with Exa's neural search engine.
|
description: Neural search via Exa MCP for web, code, and company research. Use when the user needs web search, code examples, company intel, people lookup, or AI-powered deep research with Exa's neural search engine.
|
||||||
origin: ECC
|
|
||||||
---
|
---
|
||||||
|
|
||||||
# Exa Search
|
# Exa Search
|
||||||
|
|||||||
@@ -1,7 +1,7 @@
|
|||||||
interface:
|
interface:
|
||||||
display_name: "Exa Search"
|
display_name: "Exa Search"
|
||||||
short_description: "Neural search via Exa MCP for web, code, and companies"
|
short_description: "Neural search via Exa MCP"
|
||||||
brand_color: "#8B5CF6"
|
brand_color: "#8B5CF6"
|
||||||
default_prompt: "Search using Exa MCP tools for web content, code, or company research"
|
default_prompt: "Use $exa-search to search web, code, or company data through Exa."
|
||||||
policy:
|
policy:
|
||||||
allow_implicit_invocation: true
|
allow_implicit_invocation: true
|
||||||
|
|||||||
@@ -1,7 +1,6 @@
|
|||||||
---
|
---
|
||||||
name: fal-ai-media
|
name: fal-ai-media
|
||||||
description: Unified media generation via fal.ai MCP — image, video, and audio. Covers text-to-image (Nano Banana), text/image-to-video (Seedance, Kling, Veo 3), text-to-speech (CSM-1B), and video-to-audio (ThinkSound). Use when the user wants to generate images, videos, or audio with AI.
|
description: Unified media generation via fal.ai MCP — image, video, and audio. Covers text-to-image (Nano Banana), text/image-to-video (Seedance, Kling, Veo 3), text-to-speech (CSM-1B), and video-to-audio (ThinkSound). Use when the user wants to generate images, videos, or audio with AI.
|
||||||
origin: ECC
|
|
||||||
---
|
---
|
||||||
|
|
||||||
# fal.ai Media Generation
|
# fal.ai Media Generation
|
||||||
|
|||||||
@@ -1,7 +1,7 @@
|
|||||||
interface:
|
interface:
|
||||||
display_name: "fal.ai Media"
|
display_name: "fal.ai Media"
|
||||||
short_description: "AI image, video, and audio generation via fal.ai"
|
short_description: "AI media generation via fal.ai"
|
||||||
brand_color: "#F43F5E"
|
brand_color: "#F43F5E"
|
||||||
default_prompt: "Generate images, videos, or audio using fal.ai models"
|
default_prompt: "Use $fal-ai-media to generate image, video, or audio assets with fal.ai."
|
||||||
policy:
|
policy:
|
||||||
allow_implicit_invocation: true
|
allow_implicit_invocation: true
|
||||||
|
|||||||
@@ -1,7 +1,6 @@
|
|||||||
---
|
---
|
||||||
name: frontend-patterns
|
name: frontend-patterns
|
||||||
description: Frontend development patterns for React, Next.js, state management, performance optimization, and UI best practices.
|
description: Frontend development patterns for React, Next.js, state management, performance optimization, and UI best practices.
|
||||||
origin: ECC
|
|
||||||
---
|
---
|
||||||
|
|
||||||
# Frontend Development Patterns
|
# Frontend Development Patterns
|
||||||
@@ -18,6 +17,12 @@ Modern frontend patterns for React, Next.js, and performant user interfaces.
|
|||||||
- Handling client-side routing and navigation
|
- Handling client-side routing and navigation
|
||||||
- Building accessible, responsive UI patterns
|
- Building accessible, responsive UI patterns
|
||||||
|
|
||||||
|
## Privacy and Data Boundaries
|
||||||
|
|
||||||
|
Frontend examples should use synthetic or domain-generic data. Do not collect, log, persist, or display credentials, access tokens, SSNs, health data, payment details, private emails, phone numbers, or other sensitive personal data unless the user explicitly requests a scoped implementation with appropriate validation, redaction, and access controls.
|
||||||
|
|
||||||
|
Avoid adding analytics, tracking pixels, third-party scripts, or external data sinks without explicit approval. When handling user data, prefer least-privilege APIs, client-side redaction before logging, and server-side validation for every boundary.
|
||||||
|
|
||||||
## Component Patterns
|
## Component Patterns
|
||||||
|
|
||||||
### Composition Over Inheritance
|
### Composition Over Inheritance
|
||||||
|
|||||||
@@ -1,7 +1,7 @@
|
|||||||
interface:
|
interface:
|
||||||
display_name: "Frontend Patterns"
|
display_name: "Frontend Patterns"
|
||||||
short_description: "React and Next.js patterns and best practices"
|
short_description: "React and Next.js frontend patterns"
|
||||||
brand_color: "#8B5CF6"
|
brand_color: "#8B5CF6"
|
||||||
default_prompt: "Apply React/Next.js patterns and best practices"
|
default_prompt: "Use $frontend-patterns to apply React and Next.js frontend patterns."
|
||||||
policy:
|
policy:
|
||||||
allow_implicit_invocation: true
|
allow_implicit_invocation: true
|
||||||
|
|||||||
@@ -1,7 +1,6 @@
|
|||||||
---
|
---
|
||||||
name: frontend-slides
|
name: frontend-slides
|
||||||
description: Create stunning, animation-rich HTML presentations from scratch or by converting PowerPoint files. Use when the user wants to build a presentation, convert a PPT/PPTX to web, or create slides for a talk/pitch. Helps non-designers discover their aesthetic through visual exploration rather than abstract choices.
|
description: Create stunning, animation-rich HTML presentations from scratch or by converting PowerPoint files. Use when the user wants to build a presentation, convert a PPT/PPTX to web, or create slides for a talk/pitch. Helps non-designers discover their aesthetic through visual exploration rather than abstract choices.
|
||||||
origin: ECC
|
|
||||||
---
|
---
|
||||||
|
|
||||||
# Frontend Slides
|
# Frontend Slides
|
||||||
|
|||||||
@@ -1,7 +1,7 @@
|
|||||||
interface:
|
interface:
|
||||||
display_name: "Frontend Slides"
|
display_name: "Frontend Slides"
|
||||||
short_description: "Create distinctive HTML slide decks and convert PPTX to web"
|
short_description: "Animation-rich HTML presentation decks"
|
||||||
brand_color: "#FF6B3D"
|
brand_color: "#FF6B3D"
|
||||||
default_prompt: "Create a viewport-safe HTML presentation with strong visual direction"
|
default_prompt: "Use $frontend-slides to create an animation-rich HTML presentation deck."
|
||||||
policy:
|
policy:
|
||||||
allow_implicit_invocation: true
|
allow_implicit_invocation: true
|
||||||
|
|||||||
@@ -1,7 +1,6 @@
|
|||||||
---
|
---
|
||||||
name: investor-materials
|
name: investor-materials
|
||||||
description: Create and update pitch decks, one-pagers, investor memos, accelerator applications, financial models, and fundraising materials. Use when the user needs investor-facing documents, projections, use-of-funds tables, milestone plans, or materials that must stay internally consistent across multiple fundraising assets.
|
description: Create and update pitch decks, one-pagers, investor memos, accelerator applications, financial models, and fundraising materials. Use when the user needs investor-facing documents, projections, use-of-funds tables, milestone plans, or materials that must stay internally consistent across multiple fundraising assets.
|
||||||
origin: ECC
|
|
||||||
---
|
---
|
||||||
|
|
||||||
# Investor Materials
|
# Investor Materials
|
||||||
|
|||||||
@@ -1,7 +1,7 @@
|
|||||||
interface:
|
interface:
|
||||||
display_name: "Investor Materials"
|
display_name: "Investor Materials"
|
||||||
short_description: "Create decks, memos, and financial materials from one source of truth"
|
short_description: "Investor decks, memos, and financial materials"
|
||||||
brand_color: "#7C3AED"
|
brand_color: "#7C3AED"
|
||||||
default_prompt: "Draft investor materials that stay numerically consistent across assets"
|
default_prompt: "Use $investor-materials to draft consistent investor-facing fundraising assets."
|
||||||
policy:
|
policy:
|
||||||
allow_implicit_invocation: true
|
allow_implicit_invocation: true
|
||||||
|
|||||||
@@ -1,7 +1,6 @@
|
|||||||
---
|
---
|
||||||
name: investor-outreach
|
name: investor-outreach
|
||||||
description: Draft cold emails, warm intro blurbs, follow-ups, update emails, and investor communications for fundraising. Use when the user wants outreach to angels, VCs, strategic investors, or accelerators and needs concise, personalized, investor-facing messaging.
|
description: Draft cold emails, warm intro blurbs, follow-ups, update emails, and investor communications for fundraising. Use when the user wants outreach to angels, VCs, strategic investors, or accelerators and needs concise, personalized, investor-facing messaging.
|
||||||
origin: ECC
|
|
||||||
---
|
---
|
||||||
|
|
||||||
# Investor Outreach
|
# Investor Outreach
|
||||||
|
|||||||
@@ -1,7 +1,7 @@
|
|||||||
interface:
|
interface:
|
||||||
display_name: "Investor Outreach"
|
display_name: "Investor Outreach"
|
||||||
short_description: "Write concise, personalized outreach and follow-ups for fundraising"
|
short_description: "Personalized investor outreach and follow-ups"
|
||||||
brand_color: "#059669"
|
brand_color: "#059669"
|
||||||
default_prompt: "Draft a personalized investor outreach email with a clear low-friction ask"
|
default_prompt: "Use $investor-outreach to write concise personalized investor outreach."
|
||||||
policy:
|
policy:
|
||||||
allow_implicit_invocation: true
|
allow_implicit_invocation: true
|
||||||
|
|||||||
@@ -1,7 +1,6 @@
|
|||||||
---
|
---
|
||||||
name: market-research
|
name: market-research
|
||||||
description: Conduct market research, competitive analysis, investor due diligence, and industry intelligence with source attribution and decision-oriented summaries. Use when the user wants market sizing, competitor comparisons, fund research, technology scans, or research that informs business decisions.
|
description: Conduct market research, competitive analysis, investor due diligence, and industry intelligence with source attribution and decision-oriented summaries. Use when the user wants market sizing, competitor comparisons, fund research, technology scans, or research that informs business decisions.
|
||||||
origin: ECC
|
|
||||||
---
|
---
|
||||||
|
|
||||||
# Market Research
|
# Market Research
|
||||||
|
|||||||
@@ -1,7 +1,7 @@
|
|||||||
interface:
|
interface:
|
||||||
display_name: "Market Research"
|
display_name: "Market Research"
|
||||||
short_description: "Source-attributed market, competitor, and investor research"
|
short_description: "Source-attributed market research"
|
||||||
brand_color: "#2563EB"
|
brand_color: "#2563EB"
|
||||||
default_prompt: "Research this market and summarize the decision-relevant findings"
|
default_prompt: "Use $market-research to research markets with source-attributed findings."
|
||||||
policy:
|
policy:
|
||||||
allow_implicit_invocation: true
|
allow_implicit_invocation: true
|
||||||
|
|||||||
@@ -1,7 +1,6 @@
|
|||||||
---
|
---
|
||||||
name: mcp-server-patterns
|
name: mcp-server-patterns
|
||||||
description: Build MCP servers with Node/TypeScript SDK — tools, resources, prompts, Zod validation, stdio vs Streamable HTTP. Use Context7 or official MCP docs for latest API.
|
description: Build MCP servers with Node/TypeScript SDK — tools, resources, prompts, Zod validation, stdio vs Streamable HTTP. Use Context7 or official MCP docs for latest API.
|
||||||
origin: ECC
|
|
||||||
---
|
---
|
||||||
|
|
||||||
# MCP Server Patterns
|
# MCP Server Patterns
|
||||||
|
|||||||
7
.agents/skills/mcp-server-patterns/agents/openai.yaml
Normal file
7
.agents/skills/mcp-server-patterns/agents/openai.yaml
Normal file
@@ -0,0 +1,7 @@
|
|||||||
|
interface:
|
||||||
|
display_name: "MCP Server Patterns"
|
||||||
|
short_description: "MCP server tools, resources, and prompts"
|
||||||
|
brand_color: "#0EA5E9"
|
||||||
|
default_prompt: "Use $mcp-server-patterns to build MCP tools, resources, and prompts."
|
||||||
|
policy:
|
||||||
|
allow_implicit_invocation: true
|
||||||
@@ -1,7 +1,6 @@
|
|||||||
---
|
---
|
||||||
name: nextjs-turbopack
|
name: nextjs-turbopack
|
||||||
description: Next.js 16+ and Turbopack — incremental bundling, FS caching, dev speed, and when to use Turbopack vs webpack.
|
description: Next.js 16+ and Turbopack — incremental bundling, FS caching, dev speed, and when to use Turbopack vs webpack.
|
||||||
origin: ECC
|
|
||||||
---
|
---
|
||||||
|
|
||||||
# Next.js and Turbopack
|
# Next.js and Turbopack
|
||||||
|
|||||||
@@ -1,7 +1,7 @@
|
|||||||
interface:
|
interface:
|
||||||
display_name: "Next.js Turbopack"
|
display_name: "Next.js Turbopack"
|
||||||
short_description: "Next.js 16+ and Turbopack dev bundler"
|
short_description: "Next.js and Turbopack workflow guidance"
|
||||||
brand_color: "#000000"
|
brand_color: "#000000"
|
||||||
default_prompt: "Next.js dev, Turbopack, or bundle optimization"
|
default_prompt: "Use $nextjs-turbopack to work through Next.js and Turbopack decisions."
|
||||||
policy:
|
policy:
|
||||||
allow_implicit_invocation: true
|
allow_implicit_invocation: true
|
||||||
|
|||||||
140
.agents/skills/product-capability/SKILL.md
Normal file
140
.agents/skills/product-capability/SKILL.md
Normal file
@@ -0,0 +1,140 @@
|
|||||||
|
---
|
||||||
|
name: product-capability
|
||||||
|
description: Translate PRD intent, roadmap asks, or product discussions into an implementation-ready capability plan that exposes constraints, invariants, interfaces, and unresolved decisions before multi-service work starts. Use when the user needs an ECC-native PRD-to-SRS lane instead of vague planning prose.
|
||||||
|
---
|
||||||
|
|
||||||
|
# Product Capability
|
||||||
|
|
||||||
|
This skill turns product intent into explicit engineering constraints.
|
||||||
|
|
||||||
|
Use it when the gap is not "what should we build?" but "what exactly must be true before implementation starts?"
|
||||||
|
|
||||||
|
## When to Use
|
||||||
|
|
||||||
|
- A PRD, roadmap item, discussion, or founder note exists, but the implementation constraints are still implicit
|
||||||
|
- A feature crosses multiple services, repos, or teams and needs a capability contract before coding
|
||||||
|
- Product intent is clear, but architecture, data, lifecycle, or policy implications are still fuzzy
|
||||||
|
- Senior engineers keep restating the same hidden assumptions during review
|
||||||
|
- You need a reusable artifact that can survive across harnesses and sessions
|
||||||
|
|
||||||
|
## Canonical Artifact
|
||||||
|
|
||||||
|
If the repo has a durable product-context file such as `PRODUCT.md`, `docs/product/`, or a program-spec directory, update it there.
|
||||||
|
|
||||||
|
If no capability manifest exists yet, create one using the template at:
|
||||||
|
|
||||||
|
- `docs/examples/product-capability-template.md`
|
||||||
|
|
||||||
|
The goal is not to create another planning stack. The goal is to make hidden capability constraints durable and reusable.
|
||||||
|
|
||||||
|
## Non-Negotiable Rules
|
||||||
|
|
||||||
|
- Do not invent product truth. Mark unresolved questions explicitly.
|
||||||
|
- Separate user-visible promises from implementation details.
|
||||||
|
- Call out what is fixed policy, what is architecture preference, and what is still open.
|
||||||
|
- If the request conflicts with existing repo constraints, say so clearly instead of smoothing it over.
|
||||||
|
- Prefer one reusable capability artifact over scattered ad hoc notes.
|
||||||
|
|
||||||
|
## Inputs
|
||||||
|
|
||||||
|
Read only what is needed:
|
||||||
|
|
||||||
|
1. Product intent
|
||||||
|
- issue, discussion, PRD, roadmap note, founder message
|
||||||
|
2. Current architecture
|
||||||
|
- relevant repo docs, contracts, schemas, routes, existing workflows
|
||||||
|
3. Existing capability context
|
||||||
|
- `PRODUCT.md`, design docs, RFCs, migration notes, operating-model docs
|
||||||
|
4. Delivery constraints
|
||||||
|
- auth, billing, compliance, rollout, backwards compatibility, performance, review policy
|
||||||
|
|
||||||
|
## Core Workflow
|
||||||
|
|
||||||
|
### 1. Restate the capability
|
||||||
|
|
||||||
|
Compress the ask into one precise statement:
|
||||||
|
|
||||||
|
- who the user or operator is
|
||||||
|
- what new capability exists after this ships
|
||||||
|
- what outcome changes because of it
|
||||||
|
|
||||||
|
If this statement is weak, the implementation will drift.
|
||||||
|
|
||||||
|
### 2. Resolve capability constraints
|
||||||
|
|
||||||
|
Extract the constraints that must hold before implementation:
|
||||||
|
|
||||||
|
- business rules
|
||||||
|
- scope boundaries
|
||||||
|
- invariants
|
||||||
|
- trust boundaries
|
||||||
|
- data ownership
|
||||||
|
- lifecycle transitions
|
||||||
|
- rollout / migration requirements
|
||||||
|
- failure and recovery expectations
|
||||||
|
|
||||||
|
These are the things that often live only in senior-engineer memory.
|
||||||
|
|
||||||
|
### 3. Define the implementation-facing contract
|
||||||
|
|
||||||
|
Produce an SRS-style capability plan with:
|
||||||
|
|
||||||
|
- capability summary
|
||||||
|
- explicit non-goals
|
||||||
|
- actors and surfaces
|
||||||
|
- required states and transitions
|
||||||
|
- interfaces / inputs / outputs
|
||||||
|
- data model implications
|
||||||
|
- security / billing / policy constraints
|
||||||
|
- observability and operator requirements
|
||||||
|
- open questions blocking implementation
|
||||||
|
|
||||||
|
### 4. Translate into execution
|
||||||
|
|
||||||
|
End with the exact handoff:
|
||||||
|
|
||||||
|
- ready for direct implementation
|
||||||
|
- needs architecture review first
|
||||||
|
- needs product clarification first
|
||||||
|
|
||||||
|
If useful, point to the next ECC-native lane:
|
||||||
|
|
||||||
|
- `project-flow-ops`
|
||||||
|
- `workspace-surface-audit`
|
||||||
|
- `api-connector-builder`
|
||||||
|
- `dashboard-builder`
|
||||||
|
- `tdd-workflow`
|
||||||
|
- `verification-loop`
|
||||||
|
|
||||||
|
## Output Format
|
||||||
|
|
||||||
|
Return the result in this order:
|
||||||
|
|
||||||
|
```text
|
||||||
|
CAPABILITY
|
||||||
|
- one-paragraph restatement
|
||||||
|
|
||||||
|
CONSTRAINTS
|
||||||
|
- fixed rules, invariants, and boundaries
|
||||||
|
|
||||||
|
IMPLEMENTATION CONTRACT
|
||||||
|
- actors
|
||||||
|
- surfaces
|
||||||
|
- states and transitions
|
||||||
|
- interface/data implications
|
||||||
|
|
||||||
|
NON-GOALS
|
||||||
|
- what this lane explicitly does not own
|
||||||
|
|
||||||
|
OPEN QUESTIONS
|
||||||
|
- blockers or product decisions still required
|
||||||
|
|
||||||
|
HANDOFF
|
||||||
|
- what should happen next and which ECC lane should take it
|
||||||
|
```
|
||||||
|
|
||||||
|
## Good Outcomes
|
||||||
|
|
||||||
|
- Product intent is now concrete enough to implement without rediscovering hidden constraints mid-PR.
|
||||||
|
- Engineering review has a durable artifact instead of relying on memory or Slack context.
|
||||||
|
- The resulting plan is reusable across Claude Code, Codex, Cursor, OpenCode, and ECC 2.0 planning surfaces.
|
||||||
7
.agents/skills/product-capability/agents/openai.yaml
Normal file
7
.agents/skills/product-capability/agents/openai.yaml
Normal file
@@ -0,0 +1,7 @@
|
|||||||
|
interface:
|
||||||
|
display_name: "Product Capability"
|
||||||
|
short_description: "Implementation-ready product capability plans"
|
||||||
|
brand_color: "#0EA5E9"
|
||||||
|
default_prompt: "Use $product-capability to turn product intent into an implementation plan."
|
||||||
|
policy:
|
||||||
|
allow_implicit_invocation: true
|
||||||
@@ -1,7 +1,6 @@
|
|||||||
---
|
---
|
||||||
name: security-review
|
name: security-review
|
||||||
description: Use this skill when adding authentication, handling user input, working with secrets, creating API endpoints, or implementing payment/sensitive features. Provides comprehensive security checklist and patterns.
|
description: Use this skill when adding authentication, handling user input, working with secrets, creating API endpoints, or implementing payment/sensitive features. Provides comprehensive security checklist and patterns.
|
||||||
origin: ECC
|
|
||||||
---
|
---
|
||||||
|
|
||||||
# Security Review Skill
|
# Security Review Skill
|
||||||
|
|||||||
@@ -1,7 +1,7 @@
|
|||||||
interface:
|
interface:
|
||||||
display_name: "Security Review"
|
display_name: "Security Review"
|
||||||
short_description: "Comprehensive security checklist and vulnerability detection"
|
short_description: "Security checklist and vulnerability review"
|
||||||
brand_color: "#EF4444"
|
brand_color: "#EF4444"
|
||||||
default_prompt: "Run security checklist: secrets, input validation, injection prevention"
|
default_prompt: "Use $security-review to review sensitive code with the security checklist."
|
||||||
policy:
|
policy:
|
||||||
allow_implicit_invocation: true
|
allow_implicit_invocation: true
|
||||||
|
|||||||
@@ -1,7 +1,6 @@
|
|||||||
---
|
---
|
||||||
name: strategic-compact
|
name: strategic-compact
|
||||||
description: Suggests manual context compaction at logical intervals to preserve context through task phases rather than arbitrary auto-compaction.
|
description: Suggests manual context compaction at logical intervals to preserve context through task phases rather than arbitrary auto-compaction.
|
||||||
origin: ECC
|
|
||||||
---
|
---
|
||||||
|
|
||||||
# Strategic Compact Skill
|
# Strategic Compact Skill
|
||||||
|
|||||||
@@ -2,6 +2,6 @@ interface:
|
|||||||
display_name: "Strategic Compact"
|
display_name: "Strategic Compact"
|
||||||
short_description: "Context management via strategic compaction"
|
short_description: "Context management via strategic compaction"
|
||||||
brand_color: "#14B8A6"
|
brand_color: "#14B8A6"
|
||||||
default_prompt: "Suggest task boundary compaction for context management"
|
default_prompt: "Use $strategic-compact to choose a useful context compaction boundary."
|
||||||
policy:
|
policy:
|
||||||
allow_implicit_invocation: true
|
allow_implicit_invocation: true
|
||||||
|
|||||||
@@ -1,7 +1,6 @@
|
|||||||
---
|
---
|
||||||
name: tdd-workflow
|
name: tdd-workflow
|
||||||
description: Use this skill when writing new features, fixing bugs, or refactoring code. Enforces test-driven development with 80%+ coverage including unit, integration, and E2E tests.
|
description: Use this skill when writing new features, fixing bugs, or refactoring code. Enforces test-driven development with 80%+ coverage including unit, integration, and E2E tests.
|
||||||
origin: ECC
|
|
||||||
---
|
---
|
||||||
|
|
||||||
# Test-Driven Development Workflow
|
# Test-Driven Development Workflow
|
||||||
|
|||||||
@@ -1,7 +1,7 @@
|
|||||||
interface:
|
interface:
|
||||||
display_name: "TDD Workflow"
|
display_name: "TDD Workflow"
|
||||||
short_description: "Test-driven development with 80%+ coverage"
|
short_description: "Test-driven development with coverage gates"
|
||||||
brand_color: "#22C55E"
|
brand_color: "#22C55E"
|
||||||
default_prompt: "Follow TDD: write tests first, implement, verify 80%+ coverage"
|
default_prompt: "Use $tdd-workflow to drive the change with tests before implementation."
|
||||||
policy:
|
policy:
|
||||||
allow_implicit_invocation: true
|
allow_implicit_invocation: true
|
||||||
|
|||||||
@@ -1,7 +1,6 @@
|
|||||||
---
|
---
|
||||||
name: verification-loop
|
name: verification-loop
|
||||||
description: "A comprehensive verification system for Claude Code sessions."
|
description: "A comprehensive verification system for Claude Code sessions."
|
||||||
origin: ECC
|
|
||||||
---
|
---
|
||||||
|
|
||||||
# Verification Loop Skill
|
# Verification Loop Skill
|
||||||
|
|||||||
@@ -1,7 +1,7 @@
|
|||||||
interface:
|
interface:
|
||||||
display_name: "Verification Loop"
|
display_name: "Verification Loop"
|
||||||
short_description: "Build, test, lint, typecheck verification"
|
short_description: "Build, test, lint, and typecheck verification"
|
||||||
brand_color: "#10B981"
|
brand_color: "#10B981"
|
||||||
default_prompt: "Run verification: build, test, lint, typecheck, security"
|
default_prompt: "Use $verification-loop to run build, test, lint, and typecheck verification."
|
||||||
policy:
|
policy:
|
||||||
allow_implicit_invocation: true
|
allow_implicit_invocation: true
|
||||||
|
|||||||
@@ -1,7 +1,6 @@
|
|||||||
---
|
---
|
||||||
name: video-editing
|
name: video-editing
|
||||||
description: AI-assisted video editing workflows for cutting, structuring, and augmenting real footage. Covers the full pipeline from raw capture through FFmpeg, Remotion, ElevenLabs, fal.ai, and final polish in Descript or CapCut. Use when the user wants to edit video, cut footage, create vlogs, or build video content.
|
description: AI-assisted video editing workflows for cutting, structuring, and augmenting real footage. Covers the full pipeline from raw capture through FFmpeg, Remotion, ElevenLabs, fal.ai, and final polish in Descript or CapCut. Use when the user wants to edit video, cut footage, create vlogs, or build video content.
|
||||||
origin: ECC
|
|
||||||
---
|
---
|
||||||
|
|
||||||
# Video Editing
|
# Video Editing
|
||||||
|
|||||||
@@ -1,7 +1,7 @@
|
|||||||
interface:
|
interface:
|
||||||
display_name: "Video Editing"
|
display_name: "Video Editing"
|
||||||
short_description: "AI-assisted video editing for real footage"
|
short_description: "AI-assisted editing for real footage"
|
||||||
brand_color: "#EF4444"
|
brand_color: "#EF4444"
|
||||||
default_prompt: "Edit video using AI-assisted pipeline: organize, cut, compose, generate assets, polish"
|
default_prompt: "Use $video-editing to plan an AI-assisted edit for real footage."
|
||||||
policy:
|
policy:
|
||||||
allow_implicit_invocation: true
|
allow_implicit_invocation: true
|
||||||
|
|||||||
@@ -1,7 +1,6 @@
|
|||||||
---
|
---
|
||||||
name: x-api
|
name: x-api
|
||||||
description: X/Twitter API integration for posting tweets, threads, reading timelines, search, and analytics. Covers OAuth auth patterns, rate limits, and platform-native content posting. Use when the user wants to interact with X programmatically.
|
description: X/Twitter API integration for posting tweets, threads, reading timelines, search, and analytics. Covers OAuth auth patterns, rate limits, and platform-native content posting. Use when the user wants to interact with X programmatically.
|
||||||
origin: ECC
|
|
||||||
---
|
---
|
||||||
|
|
||||||
# X API
|
# X API
|
||||||
|
|||||||
@@ -1,7 +1,7 @@
|
|||||||
interface:
|
interface:
|
||||||
display_name: "X API"
|
display_name: "X API"
|
||||||
short_description: "X/Twitter API integration for posting, threads, and analytics"
|
short_description: "X API posting, timelines, and analytics"
|
||||||
brand_color: "#000000"
|
brand_color: "#000000"
|
||||||
default_prompt: "Use X API to post tweets, threads, or retrieve timeline and search data"
|
default_prompt: "Use $x-api to build X API posting, timeline, or analytics workflows."
|
||||||
policy:
|
policy:
|
||||||
allow_implicit_invocation: true
|
allow_implicit_invocation: true
|
||||||
|
|||||||
@@ -45,60 +45,37 @@ Example:
|
|||||||
|
|
||||||
The following fields **must always be arrays**:
|
The following fields **must always be arrays**:
|
||||||
|
|
||||||
* `agents`
|
|
||||||
* `commands`
|
* `commands`
|
||||||
* `skills`
|
* `skills`
|
||||||
* `hooks` (if present)
|
* `hooks` (if present)
|
||||||
|
|
||||||
Even if there is only one entry, **strings are not accepted**.
|
Even if there is only one entry, **strings are not accepted**.
|
||||||
|
|
||||||
### Invalid
|
|
||||||
|
|
||||||
```json
|
|
||||||
{
|
|
||||||
"agents": "./agents"
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
### Valid
|
|
||||||
|
|
||||||
```json
|
|
||||||
{
|
|
||||||
"agents": ["./agents/planner.md"]
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
This applies consistently across all component path fields.
|
This applies consistently across all component path fields.
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## Path Resolution Rules (Critical)
|
## The `agents` Field: DO NOT ADD
|
||||||
|
|
||||||
### Agents MUST use explicit file paths
|
> WARNING: **CRITICAL:** Do NOT add an `"agents"` field to `plugin.json`. The Claude Code plugin validator rejects it entirely.
|
||||||
|
|
||||||
The validator **does not accept directory paths for `agents`**.
|
### Why This Matters
|
||||||
|
|
||||||
Even the following will fail:
|
The `agents` field is not part of the Claude Code plugin manifest schema. Any form of it -- string path, array of paths, or array of directories -- causes a validation error:
|
||||||
|
|
||||||
```json
|
```
|
||||||
{
|
agents: Invalid input
|
||||||
"agents": ["./agents/"]
|
|
||||||
}
|
|
||||||
```
|
```
|
||||||
|
|
||||||
Instead, you must enumerate agent files explicitly:
|
Agent `.md` files under `agents/` are discovered automatically by convention (similar to hooks). They do not need to be declared in the manifest.
|
||||||
|
|
||||||
```json
|
### History
|
||||||
{
|
|
||||||
"agents": [
|
|
||||||
"./agents/planner.md",
|
|
||||||
"./agents/architect.md",
|
|
||||||
"./agents/code-reviewer.md"
|
|
||||||
]
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
This is the most common source of validation errors.
|
Previously this repo listed agents explicitly in `plugin.json` as an array of file paths. This passed the repo's own schema but failed Claude Code's actual validator, which does not recognize the field. Removed in #1459.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Path Resolution Rules
|
||||||
|
|
||||||
### Commands and Skills
|
### Commands and Skills
|
||||||
|
|
||||||
@@ -155,16 +132,37 @@ The test `plugin.json does NOT have explicit hooks declaration` in `tests/hooks/
|
|||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
|
## The `mcpServers` Field: Keep the Empty Opt-Out
|
||||||
|
|
||||||
|
ECC keeps `.mcp.json` at the repository root for Codex plugin installs and manual MCP setup.
|
||||||
|
Claude Code also auto-discovers plugin-root `.mcp.json` files by convention, which would bundle the same MCP servers into Claude plugin installs.
|
||||||
|
|
||||||
|
Keep this field in `.claude-plugin/plugin.json`:
|
||||||
|
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"mcpServers": {}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
This explicit empty object prevents Claude plugin installs from auto-loading ECC's root MCP definitions.
|
||||||
|
Without the opt-out, strict OpenAI-compatible gateways can reject plugin MCP tool names such as `mcp__plugin_everything-claude-code_github__create_pull_request_review` because they exceed 64 characters.
|
||||||
|
|
||||||
|
Users who want the bundled MCP servers should configure them manually from `.mcp.json` or `mcp-configs/mcp-servers.json`.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
## Known Anti-Patterns
|
## Known Anti-Patterns
|
||||||
|
|
||||||
These look correct but are rejected:
|
These look correct but are rejected:
|
||||||
|
|
||||||
* String values instead of arrays
|
* String values instead of arrays
|
||||||
* Arrays of directories for `agents`
|
* **Adding `"agents"` in any form** - not a recognized manifest field, causes `Invalid input`
|
||||||
* Missing `version`
|
* Missing `version`
|
||||||
* Relying on inferred paths
|
* Relying on inferred paths
|
||||||
* Assuming marketplace behavior matches local validation
|
* Assuming marketplace behavior matches local validation
|
||||||
* **Adding `"hooks": "./hooks/hooks.json"`** - auto-loaded by convention, causes duplicate error
|
* **Adding `"hooks": "./hooks/hooks.json"`** - auto-loaded by convention, causes duplicate error
|
||||||
|
* Removing `"mcpServers": {}` - re-enables root `.mcp.json` auto-discovery for Claude plugin installs and can produce overlong MCP tool names
|
||||||
|
|
||||||
Avoid cleverness. Be explicit.
|
Avoid cleverness. Be explicit.
|
||||||
|
|
||||||
@@ -175,10 +173,6 @@ Avoid cleverness. Be explicit.
|
|||||||
```json
|
```json
|
||||||
{
|
{
|
||||||
"version": "1.1.0",
|
"version": "1.1.0",
|
||||||
"agents": [
|
|
||||||
"./agents/planner.md",
|
|
||||||
"./agents/code-reviewer.md"
|
|
||||||
],
|
|
||||||
"commands": ["./commands/"],
|
"commands": ["./commands/"],
|
||||||
"skills": ["./skills/"]
|
"skills": ["./skills/"]
|
||||||
}
|
}
|
||||||
@@ -186,7 +180,7 @@ Avoid cleverness. Be explicit.
|
|||||||
|
|
||||||
This structure has been validated against the Claude plugin validator.
|
This structure has been validated against the Claude plugin validator.
|
||||||
|
|
||||||
**Important:** Notice there is NO `"hooks"` field. The `hooks/hooks.json` file is loaded automatically by convention. Adding it explicitly causes a duplicate error.
|
**Important:** Notice there is NO `"hooks"` field and NO `"agents"` field. Both are loaded automatically by convention. Adding either explicitly causes errors.
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
@@ -194,10 +188,11 @@ This structure has been validated against the Claude plugin validator.
|
|||||||
|
|
||||||
Before submitting changes that touch `plugin.json`:
|
Before submitting changes that touch `plugin.json`:
|
||||||
|
|
||||||
1. Use explicit file paths for agents
|
1. Ensure all component fields are arrays
|
||||||
2. Ensure all component fields are arrays
|
2. Include a `version`
|
||||||
3. Include a `version`
|
3. Do NOT add `agents` or `hooks` fields (both are auto-loaded by convention)
|
||||||
4. Run:
|
4. Preserve `"mcpServers": {}` unless you are intentionally changing Claude plugin MCP bundling behavior
|
||||||
|
5. Run:
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
claude plugin validate .claude-plugin/plugin.json
|
claude plugin validate .claude-plugin/plugin.json
|
||||||
|
|||||||
@@ -1,6 +1,6 @@
|
|||||||
### Plugin Manifest Gotchas
|
### Plugin Manifest Gotchas
|
||||||
|
|
||||||
If you plan to edit `.claude-plugin/plugin.json`, be aware that the Claude plugin validator enforces several **undocumented but strict constraints** that can cause installs to fail with vague errors (for example, `agents: Invalid input`). In particular, component fields must be arrays, `agents` must use explicit file paths rather than directories, and a `version` field is required for reliable validation and installation.
|
If you plan to edit `.claude-plugin/plugin.json`, be aware that the Claude plugin validator enforces several **undocumented but strict constraints** that can cause installs to fail with vague errors (for example, `agents: Invalid input`). In particular, component fields must be arrays, `agents` is not a supported manifest field and must not be included in plugin.json, and a `version` field is required for reliable validation and installation.
|
||||||
|
|
||||||
These constraints are not obvious from public examples and have caused repeated installation failures in the past. They are documented in detail in `.claude-plugin/PLUGIN_SCHEMA_NOTES.md`, which should be reviewed before making any changes to the plugin manifest.
|
These constraints are not obvious from public examples and have caused repeated installation failures in the past. They are documented in detail in `.claude-plugin/PLUGIN_SCHEMA_NOTES.md`, which should be reviewed before making any changes to the plugin manifest.
|
||||||
|
|
||||||
|
|||||||
@@ -1,7 +1,5 @@
|
|||||||
{
|
{
|
||||||
"$schema": "https://anthropic.com/claude-code/marketplace.schema.json",
|
|
||||||
"name": "everything-claude-code",
|
"name": "everything-claude-code",
|
||||||
"description": "Battle-tested Claude Code configurations from an Anthropic hackathon winner — agents, skills, hooks, rules, and legacy command shims evolved over 10+ months of intensive daily use",
|
|
||||||
"owner": {
|
"owner": {
|
||||||
"name": "Affaan Mustafa",
|
"name": "Affaan Mustafa",
|
||||||
"email": "me@affaanmustafa.com"
|
"email": "me@affaanmustafa.com"
|
||||||
@@ -13,8 +11,8 @@
|
|||||||
{
|
{
|
||||||
"name": "everything-claude-code",
|
"name": "everything-claude-code",
|
||||||
"source": "./",
|
"source": "./",
|
||||||
"description": "The most comprehensive Claude Code plugin — 38 agents, 156 skills, 72 legacy command shims, selective install profiles, and production-ready hooks for TDD, security scanning, code review, and continuous learning",
|
"description": "The most comprehensive Claude Code plugin — 48 agents, 182 skills, 68 legacy command shims, selective install profiles, and production-ready hooks for TDD, security scanning, code review, and continuous learning",
|
||||||
"version": "1.10.0",
|
"version": "2.0.0-rc.1",
|
||||||
"author": {
|
"author": {
|
||||||
"name": "Affaan Mustafa",
|
"name": "Affaan Mustafa",
|
||||||
"email": "me@affaanmustafa.com"
|
"email": "me@affaanmustafa.com"
|
||||||
|
|||||||
@@ -1,7 +1,7 @@
|
|||||||
{
|
{
|
||||||
"name": "everything-claude-code",
|
"name": "everything-claude-code",
|
||||||
"version": "1.10.0",
|
"version": "2.0.0-rc.1",
|
||||||
"description": "Battle-tested Claude Code plugin for engineering teams — 38 agents, 156 skills, 72 legacy command shims, production-ready hooks, and selective install workflows evolved through continuous real-world use",
|
"description": "Battle-tested Claude Code plugin for engineering teams — 48 agents, 182 skills, 68 legacy command shims, production-ready hooks, and selective install workflows evolved through continuous real-world use",
|
||||||
"author": {
|
"author": {
|
||||||
"name": "Affaan Mustafa",
|
"name": "Affaan Mustafa",
|
||||||
"url": "https://x.com/affaanmustafa"
|
"url": "https://x.com/affaanmustafa"
|
||||||
@@ -22,46 +22,7 @@
|
|||||||
"automation",
|
"automation",
|
||||||
"best-practices"
|
"best-practices"
|
||||||
],
|
],
|
||||||
"agents": [
|
"mcpServers": {},
|
||||||
"./agents/architect.md",
|
|
||||||
"./agents/build-error-resolver.md",
|
|
||||||
"./agents/chief-of-staff.md",
|
|
||||||
"./agents/code-reviewer.md",
|
|
||||||
"./agents/cpp-build-resolver.md",
|
|
||||||
"./agents/cpp-reviewer.md",
|
|
||||||
"./agents/csharp-reviewer.md",
|
|
||||||
"./agents/dart-build-resolver.md",
|
|
||||||
"./agents/database-reviewer.md",
|
|
||||||
"./agents/doc-updater.md",
|
|
||||||
"./agents/docs-lookup.md",
|
|
||||||
"./agents/e2e-runner.md",
|
|
||||||
"./agents/flutter-reviewer.md",
|
|
||||||
"./agents/gan-evaluator.md",
|
|
||||||
"./agents/gan-generator.md",
|
|
||||||
"./agents/gan-planner.md",
|
|
||||||
"./agents/go-build-resolver.md",
|
|
||||||
"./agents/go-reviewer.md",
|
|
||||||
"./agents/harness-optimizer.md",
|
|
||||||
"./agents/healthcare-reviewer.md",
|
|
||||||
"./agents/java-build-resolver.md",
|
|
||||||
"./agents/java-reviewer.md",
|
|
||||||
"./agents/kotlin-build-resolver.md",
|
|
||||||
"./agents/kotlin-reviewer.md",
|
|
||||||
"./agents/loop-operator.md",
|
|
||||||
"./agents/opensource-forker.md",
|
|
||||||
"./agents/opensource-packager.md",
|
|
||||||
"./agents/opensource-sanitizer.md",
|
|
||||||
"./agents/performance-optimizer.md",
|
|
||||||
"./agents/planner.md",
|
|
||||||
"./agents/python-reviewer.md",
|
|
||||||
"./agents/pytorch-build-resolver.md",
|
|
||||||
"./agents/refactor-cleaner.md",
|
|
||||||
"./agents/rust-build-resolver.md",
|
|
||||||
"./agents/rust-reviewer.md",
|
|
||||||
"./agents/security-reviewer.md",
|
|
||||||
"./agents/tdd-guide.md",
|
|
||||||
"./agents/typescript-reviewer.md"
|
|
||||||
],
|
|
||||||
"skills": ["./skills/"],
|
"skills": ["./skills/"],
|
||||||
"commands": ["./commands/"]
|
"commands": ["./commands/"]
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -12,7 +12,7 @@ This directory contains the **Codex plugin manifest** for Everything Claude Code
|
|||||||
|
|
||||||
## What This Provides
|
## What This Provides
|
||||||
|
|
||||||
- **156 skills** from `./skills/` — reusable Codex workflows for TDD, security,
|
- **182 skills** from `./skills/` — reusable Codex workflows for TDD, security,
|
||||||
code review, architecture, and more
|
code review, architecture, and more
|
||||||
- **6 MCP servers** — GitHub, Context7, Exa, Memory, Playwright, Sequential Thinking
|
- **6 MCP servers** — GitHub, Context7, Exa, Memory, Playwright, Sequential Thinking
|
||||||
|
|
||||||
@@ -30,6 +30,9 @@ codex plugin install ./
|
|||||||
Run this from the repository root so `./` points to the repo root and `.mcp.json` resolves correctly.
|
Run this from the repository root so `./` points to the repo root and `.mcp.json` resolves correctly.
|
||||||
```
|
```
|
||||||
|
|
||||||
|
The installed plugin registers under the short slug `ecc` so tool and command names
|
||||||
|
stay below provider length limits.
|
||||||
|
|
||||||
## MCP Servers Included
|
## MCP Servers Included
|
||||||
|
|
||||||
| Server | Purpose |
|
| Server | Purpose |
|
||||||
|
|||||||
@@ -1,7 +1,7 @@
|
|||||||
{
|
{
|
||||||
"name": "everything-claude-code",
|
"name": "ecc",
|
||||||
"version": "1.10.0",
|
"version": "2.0.0-rc.1",
|
||||||
"description": "Battle-tested Codex workflows — 156 shared ECC skills, production-ready MCP configs, and selective-install-aligned conventions for TDD, security scanning, code review, and autonomous development.",
|
"description": "Battle-tested Codex workflows — 182 shared ECC skills, production-ready MCP configs, and selective-install-aligned conventions for TDD, security scanning, code review, and autonomous development.",
|
||||||
"author": {
|
"author": {
|
||||||
"name": "Affaan Mustafa",
|
"name": "Affaan Mustafa",
|
||||||
"email": "me@affaanmustafa.com",
|
"email": "me@affaanmustafa.com",
|
||||||
@@ -15,7 +15,7 @@
|
|||||||
"mcpServers": "./.mcp.json",
|
"mcpServers": "./.mcp.json",
|
||||||
"interface": {
|
"interface": {
|
||||||
"displayName": "Everything Claude Code",
|
"displayName": "Everything Claude Code",
|
||||||
"shortDescription": "156 battle-tested ECC skills plus MCP configs for TDD, security, code review, and autonomous development.",
|
"shortDescription": "182 battle-tested ECC skills plus MCP configs for TDD, security, code review, and autonomous development.",
|
||||||
"longDescription": "Everything Claude Code (ECC) is a community-maintained collection of Codex-ready skills and MCP configs evolved over 10+ months of intensive daily use. It covers TDD workflows, security scanning, code review, architecture decisions, operator workflows, and more — all in one installable plugin.",
|
"longDescription": "Everything Claude Code (ECC) is a community-maintained collection of Codex-ready skills and MCP configs evolved over 10+ months of intensive daily use. It covers TDD workflows, security scanning, code review, architecture decisions, operator workflows, and more — all in one installable plugin.",
|
||||||
"developerName": "Affaan Mustafa",
|
"developerName": "Affaan Mustafa",
|
||||||
"category": "Productivity",
|
"category": "Productivity",
|
||||||
|
|||||||
@@ -60,6 +60,12 @@ The sync script (`scripts/sync-ecc-to-codex.sh`) uses a Node-based TOML parser t
|
|||||||
- **`--update-mcp`** — explicitly replaces all ECC-managed servers with the latest recommended config (safely removes subtables like `[mcp_servers.supabase.env]`).
|
- **`--update-mcp`** — explicitly replaces all ECC-managed servers with the latest recommended config (safely removes subtables like `[mcp_servers.supabase.env]`).
|
||||||
- **User config is always preserved** — custom servers, args, env vars, and credentials outside ECC-managed sections are never touched.
|
- **User config is always preserved** — custom servers, args, env vars, and credentials outside ECC-managed sections are never touched.
|
||||||
|
|
||||||
|
## External Action Boundaries
|
||||||
|
|
||||||
|
Treat networked tools as read-only by default. Search, inspect, and draft freely within the user's requested scope, but require explicit user approval before posting, publishing, pushing, merging, opening paid jobs, dispatching remote agents, changing third-party resources, or modifying credentials.
|
||||||
|
|
||||||
|
When approval is ambiguous, produce a local plan or draft artifact instead of taking the external action. Preserve user config and private state unless the user specifically asks for a scoped change.
|
||||||
|
|
||||||
## Multi-Agent Support
|
## Multi-Agent Support
|
||||||
|
|
||||||
Codex now supports multi-agent workflows behind the experimental `features.multi_agent` flag.
|
Codex now supports multi-agent workflows behind the experimental `features.multi_agent` flag.
|
||||||
|
|||||||
@@ -1,4 +1,5 @@
|
|||||||
{
|
{
|
||||||
|
"version": 1,
|
||||||
"hooks": {
|
"hooks": {
|
||||||
"sessionStart": [
|
"sessionStart": [
|
||||||
{
|
{
|
||||||
|
|||||||
30
.github/workflows/ci.yml
vendored
30
.github/workflows/ci.yml
vendored
@@ -2,7 +2,8 @@ name: CI
|
|||||||
|
|
||||||
on:
|
on:
|
||||||
push:
|
push:
|
||||||
branches: [main]
|
branches: [main, 'release/**']
|
||||||
|
tags: ['v*']
|
||||||
pull_request:
|
pull_request:
|
||||||
branches: [main]
|
branches: [main]
|
||||||
|
|
||||||
@@ -43,10 +44,18 @@ jobs:
|
|||||||
|
|
||||||
# Package manager setup
|
# Package manager setup
|
||||||
- name: Setup pnpm
|
- name: Setup pnpm
|
||||||
if: matrix.pm == 'pnpm'
|
if: matrix.pm == 'pnpm' && matrix.node != '18.x'
|
||||||
uses: pnpm/action-setup@fc06bc1257f339d1d5d8b3a19a8cae5388b55320 # v4
|
uses: pnpm/action-setup@08c4be7e2e672a47d11bd04269e27e5f3e8529cb # v6.0.0
|
||||||
with:
|
with:
|
||||||
version: latest
|
# Keep an explicit pnpm major because this repo's packageManager is Yarn.
|
||||||
|
version: 10
|
||||||
|
|
||||||
|
- name: Setup pnpm (via Corepack)
|
||||||
|
if: matrix.pm == 'pnpm' && matrix.node == '18.x'
|
||||||
|
shell: bash
|
||||||
|
run: |
|
||||||
|
corepack enable
|
||||||
|
corepack prepare pnpm@9 --activate
|
||||||
|
|
||||||
- name: Setup Yarn (via Corepack)
|
- name: Setup Yarn (via Corepack)
|
||||||
if: matrix.pm == 'yarn'
|
if: matrix.pm == 'yarn'
|
||||||
@@ -79,6 +88,8 @@ jobs:
|
|||||||
if: matrix.pm == 'pnpm'
|
if: matrix.pm == 'pnpm'
|
||||||
id: pnpm-cache-dir
|
id: pnpm-cache-dir
|
||||||
shell: bash
|
shell: bash
|
||||||
|
env:
|
||||||
|
COREPACK_ENABLE_STRICT: '0'
|
||||||
run: echo "dir=$(pnpm store path)" >> $GITHUB_OUTPUT
|
run: echo "dir=$(pnpm store path)" >> $GITHUB_OUTPUT
|
||||||
|
|
||||||
- name: Cache pnpm
|
- name: Cache pnpm
|
||||||
@@ -130,7 +141,10 @@ jobs:
|
|||||||
run: |
|
run: |
|
||||||
case "${{ matrix.pm }}" in
|
case "${{ matrix.pm }}" in
|
||||||
npm) npm ci ;;
|
npm) npm ci ;;
|
||||||
pnpm) pnpm install --no-frozen-lockfile ;;
|
# pnpm v10 can fail CI on ignored native build scripts
|
||||||
|
# (for example msgpackr-extract) even though this repo is Yarn-native
|
||||||
|
# and pnpm is only exercised here as a compatibility lane.
|
||||||
|
pnpm) pnpm install --config.strict-dep-builds=false --no-frozen-lockfile ;;
|
||||||
# Yarn Berry (v4+) removed --ignore-engines; engine checking is no longer a core feature
|
# Yarn Berry (v4+) removed --ignore-engines; engine checking is no longer a core feature
|
||||||
yarn) yarn install ;;
|
yarn) yarn install ;;
|
||||||
bun) bun install ;;
|
bun) bun install ;;
|
||||||
@@ -146,7 +160,7 @@ jobs:
|
|||||||
# Upload test artifacts on failure
|
# Upload test artifacts on failure
|
||||||
- name: Upload test artifacts
|
- name: Upload test artifacts
|
||||||
if: failure()
|
if: failure()
|
||||||
uses: actions/upload-artifact@bbbca2ddaa5d8feaa63e36b76fdaad77386f024f # v7.0.0
|
uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7.0.1
|
||||||
with:
|
with:
|
||||||
name: test-results-${{ matrix.os }}-node${{ matrix.node }}-${{ matrix.pm }}
|
name: test-results-${{ matrix.os }}-node${{ matrix.node }}-${{ matrix.pm }}
|
||||||
path: |
|
path: |
|
||||||
@@ -190,6 +204,10 @@ jobs:
|
|||||||
run: node scripts/ci/validate-install-manifests.js
|
run: node scripts/ci/validate-install-manifests.js
|
||||||
continue-on-error: false
|
continue-on-error: false
|
||||||
|
|
||||||
|
- name: Validate workflow security
|
||||||
|
run: node scripts/ci/validate-workflow-security.js
|
||||||
|
continue-on-error: false
|
||||||
|
|
||||||
- name: Validate rules
|
- name: Validate rules
|
||||||
run: node scripts/ci/validate-rules.js
|
run: node scripts/ci/validate-rules.js
|
||||||
continue-on-error: false
|
continue-on-error: false
|
||||||
|
|||||||
2
.github/workflows/maintenance.yml
vendored
2
.github/workflows/maintenance.yml
vendored
@@ -43,7 +43,7 @@ jobs:
|
|||||||
name: Stale Issues/PRs
|
name: Stale Issues/PRs
|
||||||
runs-on: ubuntu-latest
|
runs-on: ubuntu-latest
|
||||||
steps:
|
steps:
|
||||||
- uses: actions/stale@5bef64f19d7facfb25b37b414482c7164d639639 # v9
|
- uses: actions/stale@b5d41d4e1d5dceea10e7104786b73624c18a190f # v10.2.0
|
||||||
with:
|
with:
|
||||||
stale-issue-message: 'This issue is stale due to inactivity.'
|
stale-issue-message: 'This issue is stale due to inactivity.'
|
||||||
stale-pr-message: 'This PR is stale due to inactivity.'
|
stale-pr-message: 'This PR is stale due to inactivity.'
|
||||||
|
|||||||
19
.github/workflows/monthly-metrics.yml
vendored
19
.github/workflows/monthly-metrics.yml
vendored
@@ -15,7 +15,7 @@ jobs:
|
|||||||
runs-on: ubuntu-latest
|
runs-on: ubuntu-latest
|
||||||
steps:
|
steps:
|
||||||
- name: Update monthly metrics issue
|
- name: Update monthly metrics issue
|
||||||
uses: actions/github-script@ed597411d8f924073f98dfc5c65a23a2325f34cd # v8.0.0
|
uses: actions/github-script@3a2844b7e9c422d3c10d287c895573f7108da1b3 # v9.0.0
|
||||||
with:
|
with:
|
||||||
script: |
|
script: |
|
||||||
const owner = context.repo.owner;
|
const owner = context.repo.owner;
|
||||||
@@ -30,6 +30,10 @@ jobs:
|
|||||||
return match ? Number(match[1]) : null;
|
return match ? Number(match[1]) : null;
|
||||||
}
|
}
|
||||||
|
|
||||||
|
function escapeRegex(value) {
|
||||||
|
return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
|
||||||
|
}
|
||||||
|
|
||||||
function fmt(value) {
|
function fmt(value) {
|
||||||
if (value === null || value === undefined) return "n/a";
|
if (value === null || value === undefined) return "n/a";
|
||||||
return Number(value).toLocaleString("en-US");
|
return Number(value).toLocaleString("en-US");
|
||||||
@@ -167,14 +171,17 @@ jobs:
|
|||||||
}
|
}
|
||||||
|
|
||||||
const currentBody = issue.body || "";
|
const currentBody = issue.body || "";
|
||||||
if (currentBody.includes(`| ${monthKey} |`)) {
|
const rowPattern = new RegExp(`^\\| ${escapeRegex(monthKey)} \\|.*$`, "m");
|
||||||
console.log(`Issue #${issue.number} already has snapshot row for ${monthKey}`);
|
|
||||||
return;
|
|
||||||
}
|
|
||||||
|
|
||||||
const body = currentBody.includes("| Month (UTC) |")
|
let body;
|
||||||
|
if (rowPattern.test(currentBody)) {
|
||||||
|
body = currentBody.replace(rowPattern, row);
|
||||||
|
console.log(`Refreshed issue #${issue.number} snapshot row for ${monthKey}`);
|
||||||
|
} else {
|
||||||
|
body = currentBody.includes("| Month (UTC) |")
|
||||||
? `${currentBody.trimEnd()}\n${row}\n`
|
? `${currentBody.trimEnd()}\n${row}\n`
|
||||||
: `${intro}\n${row}\n`;
|
: `${intro}\n${row}\n`;
|
||||||
|
}
|
||||||
|
|
||||||
await github.rest.issues.update({
|
await github.rest.issues.update({
|
||||||
owner,
|
owner,
|
||||||
|
|||||||
53
.github/workflows/release.yml
vendored
53
.github/workflows/release.yml
vendored
@@ -6,6 +6,7 @@ on:
|
|||||||
|
|
||||||
permissions:
|
permissions:
|
||||||
contents: write
|
contents: write
|
||||||
|
id-token: write
|
||||||
|
|
||||||
jobs:
|
jobs:
|
||||||
release:
|
release:
|
||||||
@@ -18,27 +19,55 @@ jobs:
|
|||||||
with:
|
with:
|
||||||
fetch-depth: 0
|
fetch-depth: 0
|
||||||
|
|
||||||
|
- name: Setup Node.js
|
||||||
|
uses: actions/setup-node@53b83947a5a98c8d113130e565377fae1a50d02f # v6.3.0
|
||||||
|
with:
|
||||||
|
node-version: '20.x'
|
||||||
|
registry-url: 'https://registry.npmjs.org'
|
||||||
|
|
||||||
|
- name: Install dependencies
|
||||||
|
run: npm ci
|
||||||
|
|
||||||
|
- name: Verify OpenCode package payload
|
||||||
|
run: node tests/scripts/build-opencode.test.js
|
||||||
|
|
||||||
- name: Validate version tag
|
- name: Validate version tag
|
||||||
run: |
|
run: |
|
||||||
if ! [[ "${REF_NAME}" =~ ^v[0-9]+\.[0-9]+\.[0-9]+$ ]]; then
|
if ! [[ "${REF_NAME}" =~ ^v[0-9]+\.[0-9]+\.[0-9]+(-[0-9A-Za-z.-]+)?$ ]]; then
|
||||||
echo "Invalid version tag format. Expected vX.Y.Z"
|
echo "Invalid version tag format. Expected vX.Y.Z or vX.Y.Z-prerelease"
|
||||||
exit 1
|
exit 1
|
||||||
fi
|
fi
|
||||||
|
|
||||||
env:
|
env:
|
||||||
REF_NAME: ${{ github.ref_name }}
|
REF_NAME: ${{ github.ref_name }}
|
||||||
- name: Verify plugin.json version matches tag
|
- name: Verify package version matches tag
|
||||||
env:
|
env:
|
||||||
TAG_NAME: ${{ github.ref_name }}
|
TAG_NAME: ${{ github.ref_name }}
|
||||||
run: |
|
run: |
|
||||||
TAG_VERSION="${TAG_NAME#v}"
|
TAG_VERSION="${TAG_NAME#v}"
|
||||||
PLUGIN_VERSION=$(grep -oE '"version": *"[^"]*"' .claude-plugin/plugin.json | grep -oE '[0-9]+\.[0-9]+\.[0-9]+')
|
PACKAGE_VERSION=$(node -p "require('./package.json').version")
|
||||||
if [ "$TAG_VERSION" != "$PLUGIN_VERSION" ]; then
|
if [ "$TAG_VERSION" != "$PACKAGE_VERSION" ]; then
|
||||||
echo "::error::Tag version ($TAG_VERSION) does not match plugin.json version ($PLUGIN_VERSION)"
|
echo "::error::Tag version ($TAG_VERSION) does not match package.json version ($PACKAGE_VERSION)"
|
||||||
echo "Run: ./scripts/release.sh $TAG_VERSION"
|
echo "Run: ./scripts/release.sh $TAG_VERSION"
|
||||||
exit 1
|
exit 1
|
||||||
fi
|
fi
|
||||||
|
|
||||||
|
- name: Verify release metadata stays in sync
|
||||||
|
run: node tests/plugin-manifest.test.js
|
||||||
|
|
||||||
|
- name: Check npm publish state
|
||||||
|
id: npm_publish_state
|
||||||
|
run: |
|
||||||
|
PACKAGE_NAME=$(node -p "require('./package.json').name")
|
||||||
|
PACKAGE_VERSION=$(node -p "require('./package.json').version")
|
||||||
|
NPM_DIST_TAG=$(node -p "require('./package.json').version.includes('-') ? 'next' : 'latest'")
|
||||||
|
if npm view "${PACKAGE_NAME}@${PACKAGE_VERSION}" version >/dev/null 2>&1; then
|
||||||
|
echo "already_published=true" >> "$GITHUB_OUTPUT"
|
||||||
|
else
|
||||||
|
echo "already_published=false" >> "$GITHUB_OUTPUT"
|
||||||
|
fi
|
||||||
|
echo "dist_tag=${NPM_DIST_TAG}" >> "$GITHUB_OUTPUT"
|
||||||
|
|
||||||
- name: Generate release highlights
|
- name: Generate release highlights
|
||||||
id: highlights
|
id: highlights
|
||||||
env:
|
env:
|
||||||
@@ -59,11 +88,21 @@ jobs:
|
|||||||
- Improved release-note generation and changelog hygiene
|
- Improved release-note generation and changelog hygiene
|
||||||
|
|
||||||
### Notes
|
### Notes
|
||||||
|
- npm package: \`ecc-universal\`
|
||||||
|
- Claude marketplace/plugin identifier: \`everything-claude-code@everything-claude-code\`
|
||||||
- For migration tips and compatibility notes, see README and CHANGELOG.
|
- For migration tips and compatibility notes, see README and CHANGELOG.
|
||||||
EOF
|
EOF
|
||||||
|
|
||||||
- name: Create GitHub Release
|
- name: Create GitHub Release
|
||||||
uses: softprops/action-gh-release@153bb8e04406b158c6c84fc1615b65b24149a1fe # v2
|
uses: softprops/action-gh-release@b4309332981a82ec1c5618f44dd2e27cc8bfbfda # v3.0.0
|
||||||
with:
|
with:
|
||||||
body_path: release_body.md
|
body_path: release_body.md
|
||||||
generate_release_notes: true
|
generate_release_notes: true
|
||||||
|
prerelease: ${{ contains(github.ref_name, '-') }}
|
||||||
|
make_latest: ${{ contains(github.ref_name, '-') && 'false' || 'true' }}
|
||||||
|
|
||||||
|
- name: Publish npm package
|
||||||
|
if: steps.npm_publish_state.outputs.already_published != 'true'
|
||||||
|
env:
|
||||||
|
NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
|
||||||
|
run: npm publish --access public --provenance --tag "${{ steps.npm_publish_state.outputs.dist_tag }}"
|
||||||
|
|||||||
74
.github/workflows/reusable-release.yml
vendored
74
.github/workflows/reusable-release.yml
vendored
@@ -12,9 +12,24 @@ on:
|
|||||||
required: false
|
required: false
|
||||||
type: boolean
|
type: boolean
|
||||||
default: true
|
default: true
|
||||||
|
secrets:
|
||||||
|
NPM_TOKEN:
|
||||||
|
required: false
|
||||||
|
workflow_dispatch:
|
||||||
|
inputs:
|
||||||
|
tag:
|
||||||
|
description: 'Version tag to release or republish (e.g., v2.0.0-rc.1)'
|
||||||
|
required: true
|
||||||
|
type: string
|
||||||
|
generate-notes:
|
||||||
|
description: 'Auto-generate release notes'
|
||||||
|
required: false
|
||||||
|
type: boolean
|
||||||
|
default: true
|
||||||
|
|
||||||
permissions:
|
permissions:
|
||||||
contents: write
|
contents: write
|
||||||
|
id-token: write
|
||||||
|
|
||||||
jobs:
|
jobs:
|
||||||
release:
|
release:
|
||||||
@@ -26,16 +41,57 @@ jobs:
|
|||||||
uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
|
uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
|
||||||
with:
|
with:
|
||||||
fetch-depth: 0
|
fetch-depth: 0
|
||||||
|
ref: ${{ inputs.tag }}
|
||||||
|
|
||||||
|
- name: Setup Node.js
|
||||||
|
uses: actions/setup-node@53b83947a5a98c8d113130e565377fae1a50d02f # v6.3.0
|
||||||
|
with:
|
||||||
|
node-version: '20.x'
|
||||||
|
registry-url: 'https://registry.npmjs.org'
|
||||||
|
|
||||||
|
- name: Install dependencies
|
||||||
|
run: npm ci
|
||||||
|
|
||||||
|
- name: Verify OpenCode package payload
|
||||||
|
run: node tests/scripts/build-opencode.test.js
|
||||||
|
|
||||||
- name: Validate version tag
|
- name: Validate version tag
|
||||||
env:
|
env:
|
||||||
INPUT_TAG: ${{ inputs.tag }}
|
INPUT_TAG: ${{ inputs.tag }}
|
||||||
run: |
|
run: |
|
||||||
if ! [[ "$INPUT_TAG" =~ ^v[0-9]+\.[0-9]+\.[0-9]+$ ]]; then
|
if ! [[ "$INPUT_TAG" =~ ^v[0-9]+\.[0-9]+\.[0-9]+(-[0-9A-Za-z.-]+)?$ ]]; then
|
||||||
echo "Invalid version tag format. Expected vX.Y.Z"
|
echo "Invalid version tag format. Expected vX.Y.Z or vX.Y.Z-prerelease"
|
||||||
exit 1
|
exit 1
|
||||||
fi
|
fi
|
||||||
|
|
||||||
|
- name: Verify package version matches tag
|
||||||
|
env:
|
||||||
|
INPUT_TAG: ${{ inputs.tag }}
|
||||||
|
run: |
|
||||||
|
TAG_VERSION="${INPUT_TAG#v}"
|
||||||
|
PACKAGE_VERSION=$(node -p "require('./package.json').version")
|
||||||
|
if [ "$TAG_VERSION" != "$PACKAGE_VERSION" ]; then
|
||||||
|
echo "::error::Tag version ($TAG_VERSION) does not match package.json version ($PACKAGE_VERSION)"
|
||||||
|
echo "Run: ./scripts/release.sh $TAG_VERSION"
|
||||||
|
exit 1
|
||||||
|
fi
|
||||||
|
|
||||||
|
- name: Verify release metadata stays in sync
|
||||||
|
run: node tests/plugin-manifest.test.js
|
||||||
|
|
||||||
|
- name: Check npm publish state
|
||||||
|
id: npm_publish_state
|
||||||
|
run: |
|
||||||
|
PACKAGE_NAME=$(node -p "require('./package.json').name")
|
||||||
|
PACKAGE_VERSION=$(node -p "require('./package.json').version")
|
||||||
|
NPM_DIST_TAG=$(node -p "require('./package.json').version.includes('-') ? 'next' : 'latest'")
|
||||||
|
if npm view "${PACKAGE_NAME}@${PACKAGE_VERSION}" version >/dev/null 2>&1; then
|
||||||
|
echo "already_published=true" >> "$GITHUB_OUTPUT"
|
||||||
|
else
|
||||||
|
echo "already_published=false" >> "$GITHUB_OUTPUT"
|
||||||
|
fi
|
||||||
|
echo "dist_tag=${NPM_DIST_TAG}" >> "$GITHUB_OUTPUT"
|
||||||
|
|
||||||
- name: Generate release highlights
|
- name: Generate release highlights
|
||||||
env:
|
env:
|
||||||
TAG_NAME: ${{ inputs.tag }}
|
TAG_NAME: ${{ inputs.tag }}
|
||||||
@@ -48,11 +104,23 @@ jobs:
|
|||||||
- Harness reliability and cross-platform compatibility
|
- Harness reliability and cross-platform compatibility
|
||||||
- Eval-driven quality improvements
|
- Eval-driven quality improvements
|
||||||
- Better workflow and operator ergonomics
|
- Better workflow and operator ergonomics
|
||||||
|
|
||||||
|
### Package Notes
|
||||||
|
- npm package: \`ecc-universal\`
|
||||||
|
- Claude marketplace/plugin identifier: \`everything-claude-code@everything-claude-code\`
|
||||||
EOF
|
EOF
|
||||||
|
|
||||||
- name: Create GitHub Release
|
- name: Create GitHub Release
|
||||||
uses: softprops/action-gh-release@153bb8e04406b158c6c84fc1615b65b24149a1fe # v2
|
uses: softprops/action-gh-release@b4309332981a82ec1c5618f44dd2e27cc8bfbfda # v3.0.0
|
||||||
with:
|
with:
|
||||||
tag_name: ${{ inputs.tag }}
|
tag_name: ${{ inputs.tag }}
|
||||||
body_path: release_body.md
|
body_path: release_body.md
|
||||||
generate_release_notes: ${{ inputs.generate-notes }}
|
generate_release_notes: ${{ inputs.generate-notes }}
|
||||||
|
prerelease: ${{ contains(inputs.tag, '-') }}
|
||||||
|
make_latest: ${{ contains(inputs.tag, '-') && 'false' || 'true' }}
|
||||||
|
|
||||||
|
- name: Publish npm package
|
||||||
|
if: steps.npm_publish_state.outputs.already_published != 'true'
|
||||||
|
env:
|
||||||
|
NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
|
||||||
|
run: npm publish --access public --provenance --tag "${{ steps.npm_publish_state.outputs.dist_tag }}"
|
||||||
|
|||||||
23
.github/workflows/reusable-test.yml
vendored
23
.github/workflows/reusable-test.yml
vendored
@@ -35,10 +35,18 @@ jobs:
|
|||||||
node-version: ${{ inputs.node-version }}
|
node-version: ${{ inputs.node-version }}
|
||||||
|
|
||||||
- name: Setup pnpm
|
- name: Setup pnpm
|
||||||
if: inputs.package-manager == 'pnpm'
|
if: inputs.package-manager == 'pnpm' && inputs.node-version != '18.x'
|
||||||
uses: pnpm/action-setup@fc06bc1257f339d1d5d8b3a19a8cae5388b55320 # v4
|
uses: pnpm/action-setup@08c4be7e2e672a47d11bd04269e27e5f3e8529cb # v6.0.0
|
||||||
with:
|
with:
|
||||||
version: latest
|
# Keep an explicit pnpm major because this repo's packageManager is Yarn.
|
||||||
|
version: 10
|
||||||
|
|
||||||
|
- name: Setup pnpm (via Corepack)
|
||||||
|
if: inputs.package-manager == 'pnpm' && inputs.node-version == '18.x'
|
||||||
|
shell: bash
|
||||||
|
run: |
|
||||||
|
corepack enable
|
||||||
|
corepack prepare pnpm@9 --activate
|
||||||
|
|
||||||
- name: Setup Yarn (via Corepack)
|
- name: Setup Yarn (via Corepack)
|
||||||
if: inputs.package-manager == 'yarn'
|
if: inputs.package-manager == 'yarn'
|
||||||
@@ -70,6 +78,8 @@ jobs:
|
|||||||
if: inputs.package-manager == 'pnpm'
|
if: inputs.package-manager == 'pnpm'
|
||||||
id: pnpm-cache-dir
|
id: pnpm-cache-dir
|
||||||
shell: bash
|
shell: bash
|
||||||
|
env:
|
||||||
|
COREPACK_ENABLE_STRICT: '0'
|
||||||
run: echo "dir=$(pnpm store path)" >> $GITHUB_OUTPUT
|
run: echo "dir=$(pnpm store path)" >> $GITHUB_OUTPUT
|
||||||
|
|
||||||
- name: Cache pnpm
|
- name: Cache pnpm
|
||||||
@@ -120,7 +130,10 @@ jobs:
|
|||||||
run: |
|
run: |
|
||||||
case "${{ inputs.package-manager }}" in
|
case "${{ inputs.package-manager }}" in
|
||||||
npm) npm ci ;;
|
npm) npm ci ;;
|
||||||
pnpm) pnpm install --no-frozen-lockfile ;;
|
# pnpm v10 can fail CI on ignored native build scripts
|
||||||
|
# (for example msgpackr-extract) even though this repo is Yarn-native
|
||||||
|
# and pnpm is only exercised here as a compatibility lane.
|
||||||
|
pnpm) pnpm install --config.strict-dep-builds=false --no-frozen-lockfile ;;
|
||||||
# Yarn Berry (v4+) removed --ignore-engines; engine checking is no longer a core feature
|
# Yarn Berry (v4+) removed --ignore-engines; engine checking is no longer a core feature
|
||||||
yarn) yarn install ;;
|
yarn) yarn install ;;
|
||||||
bun) bun install ;;
|
bun) bun install ;;
|
||||||
@@ -134,7 +147,7 @@ jobs:
|
|||||||
|
|
||||||
- name: Upload test artifacts
|
- name: Upload test artifacts
|
||||||
if: failure()
|
if: failure()
|
||||||
uses: actions/upload-artifact@bbbca2ddaa5d8feaa63e36b76fdaad77386f024f # v7.0.0
|
uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7.0.1
|
||||||
with:
|
with:
|
||||||
name: test-results-${{ inputs.os }}-node${{ inputs.node-version }}-${{ inputs.package-manager }}
|
name: test-results-${{ inputs.os }}-node${{ inputs.node-version }}-${{ inputs.package-manager }}
|
||||||
path: |
|
path: |
|
||||||
|
|||||||
3
.github/workflows/reusable-validate.yml
vendored
3
.github/workflows/reusable-validate.yml
vendored
@@ -42,6 +42,9 @@ jobs:
|
|||||||
- name: Validate install manifests
|
- name: Validate install manifests
|
||||||
run: node scripts/ci/validate-install-manifests.js
|
run: node scripts/ci/validate-install-manifests.js
|
||||||
|
|
||||||
|
- name: Validate workflow security
|
||||||
|
run: node scripts/ci/validate-workflow-security.js
|
||||||
|
|
||||||
- name: Validate rules
|
- name: Validate rules
|
||||||
run: node scripts/ci/validate-rules.js
|
run: node scripts/ci/validate-rules.js
|
||||||
|
|
||||||
|
|||||||
@@ -21,6 +21,12 @@ Use this skill when:
|
|||||||
- The user asks "add X functionality" and you're about to write code
|
- The user asks "add X functionality" and you're about to write code
|
||||||
- Before creating a new utility, helper, or abstraction
|
- Before creating a new utility, helper, or abstraction
|
||||||
|
|
||||||
|
## Scope and Approval Rules
|
||||||
|
|
||||||
|
Default to read-only research: inspect the repo, package metadata, docs, and public examples before recommending a dependency or integration. Do not install packages, configure MCP servers, publish artifacts, open PRs, or make external write actions from this skill unless the user has explicitly approved that action in the current task.
|
||||||
|
|
||||||
|
When a candidate requires credentials, paid services, network writes, or project-wide config changes, return a recommendation and approval checkpoint instead of applying it directly.
|
||||||
|
|
||||||
## Workflow
|
## Workflow
|
||||||
|
|
||||||
```
|
```
|
||||||
@@ -45,9 +51,9 @@ Use this skill when:
|
|||||||
│ │ as-is │ │ /Wrap │ │ Custom │ │
|
│ │ as-is │ │ /Wrap │ │ Custom │ │
|
||||||
│ └─────────┘ └──────────┘ └─────────┘ │
|
│ └─────────┘ └──────────┘ └─────────┘ │
|
||||||
├─────────────────────────────────────────────┤
|
├─────────────────────────────────────────────┤
|
||||||
│ 5. IMPLEMENT │
|
│ 5. APPROVAL CHECKPOINT / IMPLEMENT │
|
||||||
│ Install package / Configure MCP / │
|
│ Recommend package / MCP / custom code │
|
||||||
│ Write minimal custom code │
|
│ Apply only after explicit approval │
|
||||||
└─────────────────────────────────────────────┘
|
└─────────────────────────────────────────────┘
|
||||||
```
|
```
|
||||||
|
|
||||||
@@ -55,10 +61,10 @@ Use this skill when:
|
|||||||
|
|
||||||
| Signal | Action |
|
| Signal | Action |
|
||||||
|--------|--------|
|
|--------|--------|
|
||||||
| Exact match, well-maintained, MIT/Apache | **Adopt** — install and use directly |
|
| Exact match, well-maintained, MIT/Apache | **Adopt** — recommend the package and request approval before install or config changes |
|
||||||
| Partial match, good foundation | **Extend** — install + write thin wrapper |
|
| Partial match, good foundation | **Extend** — recommend the package plus a thin wrapper, then wait for approval before applying |
|
||||||
| Multiple weak matches | **Compose** — combine 2-3 small packages |
|
| Multiple weak matches | **Compose** — propose 2-3 small packages and the integration plan before installing anything |
|
||||||
| Nothing suitable found | **Build** — write custom, but informed by research |
|
| Nothing suitable found | **Build** — explain why custom code is warranted, then implement only within the approved task scope |
|
||||||
|
|
||||||
## How to Use
|
## How to Use
|
||||||
|
|
||||||
@@ -135,8 +141,8 @@ Combine for progressive discovery:
|
|||||||
Need: Check markdown files for broken links
|
Need: Check markdown files for broken links
|
||||||
Search: npm "markdown dead link checker"
|
Search: npm "markdown dead link checker"
|
||||||
Found: textlint-rule-no-dead-link (score: 9/10)
|
Found: textlint-rule-no-dead-link (score: 9/10)
|
||||||
Action: ADOPT — npm install textlint-rule-no-dead-link
|
Action: ADOPT — recommend `textlint-rule-no-dead-link` and ask before installing it
|
||||||
Result: Zero custom code, battle-tested solution
|
Result: Zero custom code if approved, battle-tested solution
|
||||||
```
|
```
|
||||||
|
|
||||||
### Example 2: "Add HTTP client wrapper"
|
### Example 2: "Add HTTP client wrapper"
|
||||||
@@ -144,8 +150,8 @@ Result: Zero custom code, battle-tested solution
|
|||||||
Need: Resilient HTTP client with retries and timeout handling
|
Need: Resilient HTTP client with retries and timeout handling
|
||||||
Search: npm "http client retry", PyPI "httpx retry"
|
Search: npm "http client retry", PyPI "httpx retry"
|
||||||
Found: got (Node) with retry plugin, httpx (Python) with built-in retry
|
Found: got (Node) with retry plugin, httpx (Python) with built-in retry
|
||||||
Action: ADOPT — use got/httpx directly with retry config
|
Action: ADOPT — recommend `got`/`httpx` directly with retry config and ask before changing dependencies
|
||||||
Result: Zero custom code, production-proven libraries
|
Result: Zero custom code if approved, production-proven libraries
|
||||||
```
|
```
|
||||||
|
|
||||||
### Example 3: "Add config file linter"
|
### Example 3: "Add config file linter"
|
||||||
@@ -153,8 +159,8 @@ Result: Zero custom code, production-proven libraries
|
|||||||
Need: Validate project config files against a schema
|
Need: Validate project config files against a schema
|
||||||
Search: npm "config linter schema", "json schema validator cli"
|
Search: npm "config linter schema", "json schema validator cli"
|
||||||
Found: ajv-cli (score: 8/10)
|
Found: ajv-cli (score: 8/10)
|
||||||
Action: ADOPT + EXTEND — install ajv-cli, write project-specific schema
|
Action: ADOPT + EXTEND — recommend `ajv-cli` plus a project-specific schema, then wait for approval before install/write
|
||||||
Result: 1 package + 1 schema file, no custom validation logic
|
Result: 1 package + 1 schema file if approved, no custom validation logic
|
||||||
```
|
```
|
||||||
|
|
||||||
## Anti-Patterns
|
## Anti-Patterns
|
||||||
|
|||||||
2
.opencode/.npmignore
Normal file
2
.opencode/.npmignore
Normal file
@@ -0,0 +1,2 @@
|
|||||||
|
node_modules
|
||||||
|
bun.lock
|
||||||
@@ -184,7 +184,7 @@ Create a detailed implementation plan for: {input}
|
|||||||
```markdown
|
```markdown
|
||||||
---
|
---
|
||||||
description: Create implementation plan
|
description: Create implementation plan
|
||||||
agent: planner
|
agent: everything-claude-code:planner
|
||||||
---
|
---
|
||||||
|
|
||||||
Create a detailed implementation plan for: $ARGUMENTS
|
Create a detailed implementation plan for: $ARGUMENTS
|
||||||
|
|||||||
@@ -1,6 +1,6 @@
|
|||||||
---
|
---
|
||||||
description: Fix build and TypeScript errors with minimal changes
|
description: Fix build and TypeScript errors with minimal changes
|
||||||
agent: build-error-resolver
|
agent: everything-claude-code:build-error-resolver
|
||||||
subtask: true
|
subtask: true
|
||||||
---
|
---
|
||||||
|
|
||||||
|
|||||||
@@ -1,6 +1,6 @@
|
|||||||
---
|
---
|
||||||
description: Save verification state and progress checkpoint
|
description: Save verification state and progress checkpoint
|
||||||
agent: build
|
agent: everything-claude-code:build
|
||||||
---
|
---
|
||||||
|
|
||||||
# Checkpoint Command
|
# Checkpoint Command
|
||||||
|
|||||||
@@ -1,6 +1,6 @@
|
|||||||
---
|
---
|
||||||
description: Review code for quality, security, and maintainability
|
description: Review code for quality, security, and maintainability
|
||||||
agent: code-reviewer
|
agent: everything-claude-code:code-reviewer
|
||||||
subtask: true
|
subtask: true
|
||||||
---
|
---
|
||||||
|
|
||||||
|
|||||||
@@ -1,6 +1,6 @@
|
|||||||
---
|
---
|
||||||
description: Generate and run E2E tests with Playwright
|
description: Generate and run E2E tests with Playwright
|
||||||
agent: e2e-runner
|
agent: everything-claude-code:e2e-runner
|
||||||
subtask: true
|
subtask: true
|
||||||
---
|
---
|
||||||
|
|
||||||
|
|||||||
@@ -1,6 +1,6 @@
|
|||||||
---
|
---
|
||||||
description: Run evaluation against acceptance criteria
|
description: Run evaluation against acceptance criteria
|
||||||
agent: build
|
agent: everything-claude-code:build
|
||||||
---
|
---
|
||||||
|
|
||||||
# Eval Command
|
# Eval Command
|
||||||
|
|||||||
@@ -1,6 +1,6 @@
|
|||||||
---
|
---
|
||||||
description: Analyze instincts and suggest or generate evolved structures
|
description: Analyze instincts and suggest or generate evolved structures
|
||||||
agent: build
|
agent: everything-claude-code:build
|
||||||
---
|
---
|
||||||
|
|
||||||
# Evolve Command
|
# Evolve Command
|
||||||
|
|||||||
@@ -1,6 +1,6 @@
|
|||||||
---
|
---
|
||||||
description: Fix Go build and vet errors
|
description: Fix Go build and vet errors
|
||||||
agent: go-build-resolver
|
agent: everything-claude-code:go-build-resolver
|
||||||
subtask: true
|
subtask: true
|
||||||
---
|
---
|
||||||
|
|
||||||
|
|||||||
@@ -1,6 +1,6 @@
|
|||||||
---
|
---
|
||||||
description: Go code review for idiomatic patterns
|
description: Go code review for idiomatic patterns
|
||||||
agent: go-reviewer
|
agent: everything-claude-code:go-reviewer
|
||||||
subtask: true
|
subtask: true
|
||||||
---
|
---
|
||||||
|
|
||||||
|
|||||||
@@ -1,6 +1,6 @@
|
|||||||
---
|
---
|
||||||
description: Go TDD workflow with table-driven tests
|
description: Go TDD workflow with table-driven tests
|
||||||
agent: tdd-guide
|
agent: everything-claude-code:tdd-guide
|
||||||
subtask: true
|
subtask: true
|
||||||
---
|
---
|
||||||
|
|
||||||
|
|||||||
@@ -1,6 +1,6 @@
|
|||||||
---
|
---
|
||||||
description: Export instincts for sharing
|
description: Export instincts for sharing
|
||||||
agent: build
|
agent: everything-claude-code:build
|
||||||
---
|
---
|
||||||
|
|
||||||
# Instinct Export Command
|
# Instinct Export Command
|
||||||
|
|||||||
@@ -1,6 +1,6 @@
|
|||||||
---
|
---
|
||||||
description: Import instincts from external sources
|
description: Import instincts from external sources
|
||||||
agent: build
|
agent: everything-claude-code:build
|
||||||
---
|
---
|
||||||
|
|
||||||
# Instinct Import Command
|
# Instinct Import Command
|
||||||
|
|||||||
@@ -1,6 +1,6 @@
|
|||||||
---
|
---
|
||||||
description: Show learned instincts (project + global) with confidence
|
description: Show learned instincts (project + global) with confidence
|
||||||
agent: build
|
agent: everything-claude-code:build
|
||||||
---
|
---
|
||||||
|
|
||||||
# Instinct Status Command
|
# Instinct Status Command
|
||||||
|
|||||||
@@ -1,6 +1,6 @@
|
|||||||
---
|
---
|
||||||
description: Extract patterns and learnings from current session
|
description: Extract patterns and learnings from current session
|
||||||
agent: build
|
agent: everything-claude-code:build
|
||||||
---
|
---
|
||||||
|
|
||||||
# Learn Command
|
# Learn Command
|
||||||
|
|||||||
@@ -1,6 +1,6 @@
|
|||||||
---
|
---
|
||||||
description: Orchestrate multiple agents for complex tasks
|
description: Orchestrate multiple agents for complex tasks
|
||||||
agent: planner
|
agent: everything-claude-code:planner
|
||||||
subtask: true
|
subtask: true
|
||||||
---
|
---
|
||||||
|
|
||||||
|
|||||||
@@ -1,6 +1,6 @@
|
|||||||
---
|
---
|
||||||
description: Create implementation plan with risk assessment
|
description: Create implementation plan with risk assessment
|
||||||
agent: planner
|
agent: everything-claude-code:planner
|
||||||
subtask: true
|
subtask: true
|
||||||
---
|
---
|
||||||
|
|
||||||
|
|||||||
Some files were not shown because too many files have changed in this diff Show More
Reference in New Issue
Block a user