Skip to content

Commit 9ecfd25

Browse files
anthony-maioanthony-maio
committed
feat: seed curated founding skills
1 parent 8486cc8 commit 9ecfd25

46 files changed

Lines changed: 7789 additions & 104 deletions

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

‎README.md‎

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -24,6 +24,7 @@ synthesis-skills/
2424

2525
- Each skill lives at `skills/<skill-name>/`.
2626
- Each skill must include `SKILL.md`.
27+
- Each skill must include `PROVENANCE.json`.
2728
- Optional directories are `scripts/`, `assets/`, `references/`, and `agents/`.
2829
- Skill front matter is intentionally small: `name` and `description`.
2930
- `description` must start with `Use when`.
@@ -55,7 +56,7 @@ This repository primarily stores curated `TRUSTED` skills plus the automation ne
5556

5657
1. Open a PR that adds or updates a skill under `skills/`.
5758
2. Run validation and regenerate the catalog.
58-
3. Include provenance, intended host agents, and any helper scripts in the PR.
59+
3. Include `PROVENANCE.json`, intended host agents, and any helper scripts in the PR.
5960
4. Let CI and review decide whether the skill should merge.
6061

6162
More detail lives in [docs/submitting-skills.md](docs/submitting-skills.md).

‎catalog/skills.json‎

Lines changed: 255 additions & 25 deletions
Original file line numberDiff line numberDiff line change
@@ -1,44 +1,274 @@
11
{
22
"repo": "anthony-maio/synthesis-skills",
33
"schema_version": 1,
4-
"skill_count": 1,
4+
"skill_count": 6,
55
"skills": [
66
{
7-
"name": "csv-parsing-basics",
8-
"description": "Use when parsing CSV files, checking delimiters, or inspecting column headers before heavier data work.",
7+
"name": "deep-research-synthesizer",
8+
"description": "Use when synthesizing five research sub-agent outputs into one citation-backed report with validation, deduplication, and explicit failure handling.",
99
"keywords": [
10-
"csv",
11-
"parsing",
12-
"basics",
13-
"files",
14-
"checking",
15-
"delimiters",
16-
"inspecting",
17-
"column",
18-
"headers",
19-
"before",
20-
"heavier",
21-
"data",
22-
"work",
23-
"overview",
10+
"deep",
11+
"research",
12+
"synthesizer",
13+
"synthesizing",
14+
"five",
15+
"sub",
16+
"agent",
17+
"outputs",
18+
"one",
19+
"citation",
20+
"backed",
21+
"report",
22+
"validation",
23+
"deduplication",
24+
"explicit",
25+
"failure",
26+
"handling",
2427
"this",
2528
"skill",
26-
"inspect",
29+
"you",
30+
"have",
31+
"results",
32+
"need",
33+
"produce"
34+
],
35+
"trust_level": "trusted",
36+
"source_type": "canonical",
37+
"relative_path": "skills/deep-research-synthesizer",
38+
"repo": "anthony-maio/synthesis-skills",
39+
"package_dirs": [
40+
"references",
41+
"scripts"
42+
],
43+
"upstream": "https://github.com/anthony-maio/pieces-agent-skills/tree/main/deep-research-synthesizer",
44+
"provenance": {
45+
"kind": "first_party",
46+
"author": "Anthony Maio",
47+
"source": "D:/Development/pieces-agent-skills/deep-research-synthesizer",
48+
"upstream": "https://github.com/anthony-maio/pieces-agent-skills/tree/main/deep-research-synthesizer",
49+
"source_license": "MIT",
50+
"notes": "Curated from a separate Anthony Maio skill repository and normalized for the canonical Synthesis registry."
51+
}
52+
},
53+
{
54+
"name": "repo-surveyor",
55+
"description": "Use when Cartograph CLI or MCP is unavailable and you still need Cartograph-style repo orientation, task context, or documentation inputs from manual file survey.",
56+
"keywords": [
57+
"repo",
58+
"surveyor",
59+
"cartograph",
60+
"cli",
61+
"mcp",
62+
"is",
63+
"unavailable",
64+
"you",
65+
"still",
66+
"need",
67+
"style",
68+
"orientation",
69+
"task",
70+
"context",
71+
"documentation",
72+
"inputs",
73+
"manual",
2774
"file",
28-
"quickly",
29-
"deeper",
30-
"analysis",
31-
"transformation",
75+
"survey",
76+
"overview",
77+
"this",
78+
"skill",
79+
"only",
80+
"itself"
81+
],
82+
"trust_level": "trusted",
83+
"source_type": "canonical",
84+
"relative_path": "skills/repo-surveyor",
85+
"repo": "anthony-maio/synthesis-skills",
86+
"package_dirs": [],
87+
"upstream": "C:/Users/Ant/.agents/skills/repo-surveyor",
88+
"provenance": {
89+
"kind": "first_party",
90+
"author": "Anthony Maio",
91+
"source": "C:/Users/Ant/.agents/skills/repo-surveyor",
92+
"notes": "Curated from the maintainer's local agent skill library and normalized for the canonical Synthesis registry."
93+
}
94+
},
95+
{
96+
"name": "systematic-debugging",
97+
"description": "Use when encountering any bug, test failure, or unexpected behavior, before proposing fixes",
98+
"keywords": [
99+
"systematic",
100+
"debugging",
101+
"encountering",
102+
"any",
103+
"bug",
104+
"test",
105+
"failure",
106+
"unexpected",
107+
"behavior",
108+
"before",
109+
"proposing",
110+
"fixes",
111+
"overview",
112+
"random",
113+
"waste",
114+
"time",
115+
"create",
116+
"new",
117+
"bugs",
118+
"quick",
119+
"patches",
120+
"mask",
121+
"underlying",
122+
"issues"
123+
],
124+
"trust_level": "trusted",
125+
"source_type": "canonical",
126+
"relative_path": "skills/systematic-debugging",
127+
"repo": "anthony-maio/synthesis-skills",
128+
"package_dirs": [
129+
"references",
130+
"scripts"
131+
],
132+
"upstream": "C:/Users/Ant/.agents/skills/systematic-debugging",
133+
"provenance": {
134+
"kind": "first_party",
135+
"author": "Anthony Maio",
136+
"source": "C:/Users/Ant/.agents/skills/systematic-debugging",
137+
"notes": "Curated from the maintainer's local agent skill library and normalized for the canonical Synthesis registry."
138+
}
139+
},
140+
{
141+
"name": "test-driven-development",
142+
"description": "Use when implementing any feature or bugfix, before writing implementation code",
143+
"keywords": [
144+
"test",
145+
"driven",
146+
"development",
147+
"implementing",
148+
"any",
149+
"feature",
150+
"bugfix",
151+
"before",
152+
"writing",
153+
"implementation",
154+
"code",
155+
"tdd",
156+
"overview",
157+
"write",
158+
"first",
159+
"watch",
32160
"it",
33-
"helps"
161+
"fail",
162+
"minimal",
163+
"pass",
164+
"core",
165+
"principle",
166+
"you",
167+
"didn"
34168
],
35169
"trust_level": "trusted",
36170
"source_type": "canonical",
37-
"relative_path": "skills/csv-parsing-basics",
171+
"relative_path": "skills/test-driven-development",
38172
"repo": "anthony-maio/synthesis-skills",
39173
"package_dirs": [
174+
"references"
175+
],
176+
"upstream": "C:/Users/Ant/.agents/skills/test-driven-development",
177+
"provenance": {
178+
"kind": "first_party",
179+
"author": "Anthony Maio",
180+
"source": "C:/Users/Ant/.agents/skills/test-driven-development",
181+
"notes": "Curated from the maintainer's local agent skill library and normalized for the canonical Synthesis registry."
182+
}
183+
},
184+
{
185+
"name": "writing-clearly-and-concisely",
186+
"description": "Use when writing prose humans will read\u2014documentation, commit messages, error messages, explanations, reports, or UI text. Applies Strunk's timeless rules for clearer, stronger, more professional writing.",
187+
"keywords": [
188+
"writing",
189+
"clearly",
190+
"concisely",
191+
"prose",
192+
"humans",
193+
"will",
194+
"read",
195+
"documentation",
196+
"commit",
197+
"messages",
198+
"error",
199+
"explanations",
200+
"reports",
201+
"ui",
202+
"text",
203+
"applies",
204+
"strunk",
205+
"s",
206+
"timeless",
207+
"rules",
208+
"clearer",
209+
"stronger",
210+
"more",
211+
"professional"
212+
],
213+
"trust_level": "trusted",
214+
"source_type": "canonical",
215+
"relative_path": "skills/writing-clearly-and-concisely",
216+
"repo": "anthony-maio/synthesis-skills",
217+
"package_dirs": [
218+
"references"
219+
],
220+
"upstream": "C:/Users/Ant/.agents/skills/writing-clearly-and-concisely",
221+
"provenance": {
222+
"kind": "first_party",
223+
"author": "Anthony Maio",
224+
"source": "C:/Users/Ant/.agents/skills/writing-clearly-and-concisely",
225+
"notes": "Curated from the maintainer's local agent skill library and normalized for the canonical Synthesis registry."
226+
}
227+
},
228+
{
229+
"name": "writing-skills",
230+
"description": "Use when creating new skills, editing existing skills, or verifying skills work before deployment",
231+
"keywords": [
232+
"writing",
233+
"skills",
234+
"creating",
235+
"new",
236+
"editing",
237+
"existing",
238+
"verifying",
239+
"work",
240+
"before",
241+
"deployment",
242+
"overview",
243+
"is",
244+
"test",
245+
"driven",
246+
"development",
247+
"applied",
248+
"process",
249+
"documentation",
250+
"personal",
251+
"live",
252+
"agent",
253+
"specific",
254+
"directories",
255+
"claude"
256+
],
257+
"trust_level": "trusted",
258+
"source_type": "canonical",
259+
"relative_path": "skills/writing-skills",
260+
"repo": "anthony-maio/synthesis-skills",
261+
"package_dirs": [
262+
"references",
40263
"scripts"
41-
]
264+
],
265+
"upstream": "C:/Users/Ant/.agents/skills/writing-skills",
266+
"provenance": {
267+
"kind": "first_party",
268+
"author": "Anthony Maio",
269+
"source": "C:/Users/Ant/.agents/skills/writing-skills",
270+
"notes": "Curated from the maintainer's local agent skill library and normalized for the canonical Synthesis registry."
271+
}
42272
}
43273
]
44274
}

‎docs/repo-layout.md‎

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -16,10 +16,11 @@ Each skill package must look like:
1616
```text
1717
skills/<skill-name>/
1818
├── SKILL.md
19+
├── PROVENANCE.json
1920
├── scripts/ # optional
2021
├── assets/ # optional
2122
├── references/ # optional
2223
└── agents/ # optional
2324
```
2425

25-
The repo does not require a second manifest file. Machine-readable search metadata is generated into the catalog.
26+
`PROVENANCE.json` records origin, authorship, and licensing context without bloating `SKILL.md`. Machine-readable search metadata is generated into the catalog.

‎docs/submitting-skills.md‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -6,6 +6,7 @@ This repository is the canonical curated landing zone for Synthesis skills.
66

77
- A skill directory under `skills/<skill-name>/`
88
- A `SKILL.md` with `name` and `description` front matter
9+
- A `PROVENANCE.json` describing origin and authorship
910
- Helper code only when the skill actually needs it
1011
- Provenance notes in the PR description when material was adapted from another source
1112

0 commit comments

Comments
 (0)