blog-taxonomy

Name: blog-taxonomy
Author: AgriciDaniel

1.3kinstalls251forks

How to install blog-taxonomy?

agricidaniel/claude-blog/blog-taxonomy

$npx -y skills add AgriciDaniel/claude-blog --skill blog-taxonomy

Installs into the current project.

Summary

Extract, suggest, and sync tags and categories for blog posts across all major CMS platforms. Supports WordPress REST API, Shopify GraphQL, Ghost Content API, Strapi REST/GraphQL, and Sanity GROQ. Generates tag suggestions from content analysis (keyword frequency, heading extract

Files · 1

View on GitHub

SKILL.md

1	# Blog Taxonomy
2
3	Manage tags, categories, and topic clusters across CMS platforms.
4
5	## Commands
6
7	\| Command \| Purpose \|
8	\|---------\|---------\|
9	\| `/blog taxonomy suggest <file>` \| Extract candidate tags and categories from content \|
10	\| `/blog taxonomy sync <cms>` \| Push taxonomy to CMS via authenticated API \|
11	\| `/blog taxonomy audit [directory]` \| Check for thin tags, orphan tags, taxonomy bloat \|
12
13	## Tag Suggestion Workflow
14
15	### Step 1: Parse Content Structure
16
17	Read the target file and extract:
18	- All H2 and H3 headings (primary topic signals)
19	- Bold and italic phrases (emphasis signals)
20	- Existing frontmatter tags/categories if present
21
22	### Step 2: Frequency Analysis
23
24	Scan the body text for high-frequency phrases:
25	- 1-word terms: minimum 4 occurrences (excluding stop words)
26	- 2-word phrases: minimum 3 occurrences
27	- 3-word phrases: minimum 2 occurrences
28
29	Exclude common non-tag words: articles, prepositions, conjunctions, pronouns.
30
31	### Step 3: Semantic Grouping
32
33	Group related candidates into clusters:
34	- Merge singular/plural variants (keep the more common form)
35	- Merge hyphenated and non-hyphenated forms
36	- Group synonyms under the highest-frequency term
37
38	### Step 4: Deduplicate and Rank
39
40	- Fuzzy match on slugified names (Levenshtein distance <= 2)
41	- Score each candidate: `(frequency * 2) + (heading_presence * 5) + (emphasis * 1)`
42	- Return top 5-10 ranked suggestions
43
44	### Output Format
45
46	```
47	## Tag Suggestions: [Post Title]
48
49	\| Rank \| Tag \| Score \| Source \|
50	\|------\|-----\|-------\|--------\|
51	\| 1 \| content-marketing \| 18 \| H2 + 6 mentions \|
52	\| 2 \| seo-strategy \| 14 \| H3 + 4 mentions \|
53	\| 3 \| keyword-research \| 11 \| 5 mentions + bold \|
54
55	### Suggested Categories
56	- Primary: [best-fit category]
57	- Secondary: [optional second category]
58	```
59
60	## CMS Adapters
61
62	### Adapter Overview
63
64	\| CMS \| API Type \| Auth Method \| Tags Model \|
65	\|-----\|----------\|-------------\|------------\|
66	\| WordPress \| REST \| Application Passwords (base64) \| First-class entities with IDs \|
67	\| Shopify \| GraphQL (Admin API) \| Admin API access token \| String array on Article \|
68	\| Ghost \| REST (Admin API) \| API key with JWT signing \| First-class entities \|
69	\| Strapi \| REST or GraphQL \| API token (Bearer) \| User-defined content type \|
70	\| Sanity \| GROQ / Mutations \| Project token (Bearer) \| Document type \|
71
72	### WordPress Adapter
73
74	List tags:
75	```
76	GET {CMS_URL}/wp-json/wp/v2/tags?per_page=100&search={keyword}
77	Authorization: Basic {base64(username:app_password)}
78	```
79
80	Create tag:
81	```
82	POST {CMS_URL}/wp-json/wp/v2/tags
83	Body: {"name": "Tag Name", "slug": "tag-name", "description": "Optional"}
84	```
85
86	List categories (hierarchical, supports parent field):
87	```
88	GET {CMS_URL}/wp-json/wp/v2/categories?per_page=100
89	```
90
91	Create category:
92	```
93	POST {CMS_URL}/wp-json/wp/v2/categories
94	Body: {"name": "Category", "slug": "category", "parent": 0}
95	```
96
97	Assign tags to post:
98	```
99	POST {CMS_URL}/wp-json/wp/v2/posts/{id}
100	Body: {"tags": [1, 2, 3], "categories": [4]}
101	```
102
103	Pagination: follow `X-WP-TotalPages` header for full listing.
104
105	### Shopify Adapter
106
107	Tags on Shopify are string arrays on the Article object, not first-class entities.
108
109	Update article tags (GraphQL Admin API):
110	```graphql
111	mutation {
112	articleUpdate(id: "gid://shopify/Article/123", article: {
113	tags: ["tag-one", "tag-two", "tag-three"]
114	}) {
115	article { id tags }
116	userErrors { field message }
117	}
118	}
119	```
120
121	List all tags in use (GraphQL):
122	```graphql
123	{
124	articles(first: 250) {
125	edges {
126	node { id title tags }
127	}
128	}
129	}
130	```
131
132	Auth header: `X-Shopify-Access-Token: {token}`
133
134	Note: REST API marked legacy Oct 2024. GraphQL required for new apps since Apr 2025.
135
136	### Ghost Adapter
137
138	List tags:
139	```
140	GET {CMS_URL}/ghost/api/admin/tags/?limit=all
141	Authorization: Ghost {jwt_token}
142	```
143
144	Create tag:
145	```
146	POST {CMS_URL}/ghost/api/admin/tags/
147	Body: {"tags": [{"name": "Tag Name", "slug": "tag-name"}]}
148	```
149
150	JWT generation: sign with admin API key (id:secret format), iat = now, exp = 5 min,
151	audience = `/admin/`.
152
153	### Strapi Adapter
154
155	Endpoint auto-generated from content types. Typical setup:
156
157	```
158	GET {CMS_URL}/api/tags?pagination[pageSize]=100
159	POST {CMS_URL}/api/tags
160	Body: {"data": {"name": "Tag Name", "slug": "tag-name"}}
161	Authorization: Bearer {api_token}
162	```
163
164	Strapi v4+ uses the `data` wrapper. Check your content type schema for field names.

People who liked this also viewed

6 picks

Type

blog-taxonomy

1.3kinstalls251forks

View on GitHub

How to install blog-taxonomy?

agricidaniel/claude-blog/blog-taxonomy

$npx -y skills add AgriciDaniel/claude-blog --skill blog-taxonomy

Installs into the current project.

Summary

Files · 1

View on GitHub

SKILL.md

1	# Blog Taxonomy
2
3	Manage tags, categories, and topic clusters across CMS platforms.
4
5	## Commands
6
7	\| Command \| Purpose \|
8	\|---------\|---------\|
9	\| `/blog taxonomy suggest <file>` \| Extract candidate tags and categories from content \|
10	\| `/blog taxonomy sync <cms>` \| Push taxonomy to CMS via authenticated API \|
11	\| `/blog taxonomy audit [directory]` \| Check for thin tags, orphan tags, taxonomy bloat \|
12
13	## Tag Suggestion Workflow
14
15	### Step 1: Parse Content Structure
16
17	Read the target file and extract:
18	- All H2 and H3 headings (primary topic signals)
19	- Bold and italic phrases (emphasis signals)
20	- Existing frontmatter tags/categories if present
21
22	### Step 2: Frequency Analysis
23
24	Scan the body text for high-frequency phrases:
25	- 1-word terms: minimum 4 occurrences (excluding stop words)
26	- 2-word phrases: minimum 3 occurrences
27	- 3-word phrases: minimum 2 occurrences
28
29	Exclude common non-tag words: articles, prepositions, conjunctions, pronouns.
30
31	### Step 3: Semantic Grouping
32
33	Group related candidates into clusters:
34	- Merge singular/plural variants (keep the more common form)
35	- Merge hyphenated and non-hyphenated forms
36	- Group synonyms under the highest-frequency term
37
38	### Step 4: Deduplicate and Rank
39
40	- Fuzzy match on slugified names (Levenshtein distance <= 2)
41	- Score each candidate: `(frequency * 2) + (heading_presence * 5) + (emphasis * 1)`
42	- Return top 5-10 ranked suggestions
43
44	### Output Format
45
46	```
47	## Tag Suggestions: [Post Title]
48
49	\| Rank \| Tag \| Score \| Source \|
50	\|------\|-----\|-------\|--------\|
51	\| 1 \| content-marketing \| 18 \| H2 + 6 mentions \|
52	\| 2 \| seo-strategy \| 14 \| H3 + 4 mentions \|
53	\| 3 \| keyword-research \| 11 \| 5 mentions + bold \|
54
55	### Suggested Categories
56	- Primary: [best-fit category]
57	- Secondary: [optional second category]
58	```
59
60	## CMS Adapters
61
62	### Adapter Overview
63
64	\| CMS \| API Type \| Auth Method \| Tags Model \|
65	\|-----\|----------\|-------------\|------------\|
66	\| WordPress \| REST \| Application Passwords (base64) \| First-class entities with IDs \|
67	\| Shopify \| GraphQL (Admin API) \| Admin API access token \| String array on Article \|
68	\| Ghost \| REST (Admin API) \| API key with JWT signing \| First-class entities \|
69	\| Strapi \| REST or GraphQL \| API token (Bearer) \| User-defined content type \|
70	\| Sanity \| GROQ / Mutations \| Project token (Bearer) \| Document type \|
71
72	### WordPress Adapter
73
74	List tags:
75	```
76	GET {CMS_URL}/wp-json/wp/v2/tags?per_page=100&search={keyword}
77	Authorization: Basic {base64(username:app_password)}
78	```
79
80	Create tag:
81	```
82	POST {CMS_URL}/wp-json/wp/v2/tags
83	Body: {"name": "Tag Name", "slug": "tag-name", "description": "Optional"}
84	```
85
86	List categories (hierarchical, supports parent field):
87	```
88	GET {CMS_URL}/wp-json/wp/v2/categories?per_page=100
89	```
90
91	Create category:
92	```
93	POST {CMS_URL}/wp-json/wp/v2/categories
94	Body: {"name": "Category", "slug": "category", "parent": 0}
95	```
96
97	Assign tags to post:
98	```
99	POST {CMS_URL}/wp-json/wp/v2/posts/{id}
100	Body: {"tags": [1, 2, 3], "categories": [4]}
101	```
102
103	Pagination: follow `X-WP-TotalPages` header for full listing.
104
105	### Shopify Adapter
106
107	Tags on Shopify are string arrays on the Article object, not first-class entities.
108
109	Update article tags (GraphQL Admin API):
110	```graphql
111	mutation {
112	articleUpdate(id: "gid://shopify/Article/123", article: {
113	tags: ["tag-one", "tag-two", "tag-three"]
114	}) {
115	article { id tags }
116	userErrors { field message }
117	}
118	}
119	```
120
121	List all tags in use (GraphQL):
122	```graphql
123	{
124	articles(first: 250) {
125	edges {
126	node { id title tags }
127	}
128	}
129	}
130	```
131
132	Auth header: `X-Shopify-Access-Token: {token}`
133
134	Note: REST API marked legacy Oct 2024. GraphQL required for new apps since Apr 2025.
135
136	### Ghost Adapter
137
138	List tags:
139	```
140	GET {CMS_URL}/ghost/api/admin/tags/?limit=all
141	Authorization: Ghost {jwt_token}
142	```
143
144	Create tag:
145	```
146	POST {CMS_URL}/ghost/api/admin/tags/
147	Body: {"tags": [{"name": "Tag Name", "slug": "tag-name"}]}
148	```
149
150	JWT generation: sign with admin API key (id:secret format), iat = now, exp = 5 min,
151	audience = `/admin/`.
152
153	### Strapi Adapter
154
155	Endpoint auto-generated from content types. Typical setup:
156
157	```
158	GET {CMS_URL}/api/tags?pagination[pageSize]=100
159	POST {CMS_URL}/api/tags
160	Body: {"data": {"name": "Tag Name", "slug": "tag-name"}}
161	Authorization: Bearer {api_token}
162	```
163
164	Strapi v4+ uses the `data` wrapper. Check your content type schema for field names.

People who liked this also viewed

6 picks

Type