opencode-skills-collection 3.0.27 → 3.0.28
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/bundled-skills/.antigravity-install-manifest.json +6 -1
- package/bundled-skills/docs/integrations/jetski-cortex.md +3 -3
- package/bundled-skills/docs/integrations/jetski-gemini-loader/README.md +1 -1
- package/bundled-skills/docs/maintainers/repo-growth-seo.md +3 -3
- package/bundled-skills/docs/maintainers/skills-update-guide.md +1 -1
- package/bundled-skills/docs/users/bundles.md +1 -1
- package/bundled-skills/docs/users/claude-code-skills.md +1 -1
- package/bundled-skills/docs/users/gemini-cli-skills.md +1 -1
- package/bundled-skills/docs/users/getting-started.md +1 -1
- package/bundled-skills/docs/users/kiro-integration.md +1 -1
- package/bundled-skills/docs/users/usage.md +4 -4
- package/bundled-skills/docs/users/visual-guide.md +4 -4
- package/bundled-skills/flowhunt-skill/SKILL.md +141 -0
- package/bundled-skills/geminiignore-finops/SKILL.md +173 -0
- package/bundled-skills/ii-commons/SKILL.md +110 -0
- package/bundled-skills/mesh-memory/SKILL.md +161 -0
- package/bundled-skills/socialclaw/SKILL.md +107 -0
- package/package.json +1 -1
- package/skills_index.json +110 -0
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"schemaVersion": 1,
|
|
3
|
-
"updatedAt": "2026-05-
|
|
3
|
+
"updatedAt": "2026-05-27T02:07:52.841Z",
|
|
4
4
|
"entries": [
|
|
5
5
|
"00-andruia-consultant",
|
|
6
6
|
"007",
|
|
@@ -572,6 +572,7 @@
|
|
|
572
572
|
"fixing-accessibility",
|
|
573
573
|
"fixing-metadata",
|
|
574
574
|
"fixing-motion-performance",
|
|
575
|
+
"flowhunt-skill",
|
|
575
576
|
"flutter-expert",
|
|
576
577
|
"food-database-query",
|
|
577
578
|
"form-cro",
|
|
@@ -623,6 +624,7 @@
|
|
|
623
624
|
"gdpr-data-handling",
|
|
624
625
|
"gemini-api-dev",
|
|
625
626
|
"gemini-api-integration",
|
|
627
|
+
"geminiignore-finops",
|
|
626
628
|
"geo-fundamentals",
|
|
627
629
|
"geoffrey-hinton",
|
|
628
630
|
"gh-review-requests",
|
|
@@ -716,6 +718,7 @@
|
|
|
716
718
|
"idea-os",
|
|
717
719
|
"identity-mirror",
|
|
718
720
|
"idor-testing",
|
|
721
|
+
"ii-commons",
|
|
719
722
|
"ilya-sutskever",
|
|
720
723
|
"image-studio",
|
|
721
724
|
"imagen",
|
|
@@ -863,6 +866,7 @@
|
|
|
863
866
|
"mental-health-analyzer",
|
|
864
867
|
"mercury-mcp",
|
|
865
868
|
"mermaid-expert",
|
|
869
|
+
"mesh-memory",
|
|
866
870
|
"metasploit-framework",
|
|
867
871
|
"micro-saas-launcher",
|
|
868
872
|
"microservices-patterns",
|
|
@@ -1238,6 +1242,7 @@
|
|
|
1238
1242
|
"social-orchestrator",
|
|
1239
1243
|
"social-post-writer-seo",
|
|
1240
1244
|
"social-proof-architect",
|
|
1245
|
+
"socialclaw",
|
|
1241
1246
|
"software-architecture",
|
|
1242
1247
|
"solidity-security",
|
|
1243
1248
|
"spark-optimization",
|
|
@@ -1,9 +1,9 @@
|
|
|
1
1
|
---
|
|
2
2
|
title: Jetski/Cortex + Gemini Integration Guide
|
|
3
|
-
description: "Use antigravity-awesome-skills with Jetski/Cortex without hitting context-window overflow with 1,
|
|
3
|
+
description: "Use antigravity-awesome-skills with Jetski/Cortex without hitting context-window overflow with 1,470+ skills."
|
|
4
4
|
---
|
|
5
5
|
|
|
6
|
-
# Jetski/Cortex + Gemini: safe integration with 1,
|
|
6
|
+
# Jetski/Cortex + Gemini: safe integration with 1,470+ skills
|
|
7
7
|
|
|
8
8
|
This guide shows how to integrate the `antigravity-awesome-skills` repository with an agent based on **Jetski/Cortex + Gemini** (or similar frameworks) **without exceeding the model context window**.
|
|
9
9
|
|
|
@@ -23,7 +23,7 @@ Never do:
|
|
|
23
23
|
- concatenate all `SKILL.md` content into a single system prompt;
|
|
24
24
|
- re-inject the entire library for **every** request.
|
|
25
25
|
|
|
26
|
-
With 1,
|
|
26
|
+
With 1,470+ skills, this approach fills the context window before user messages are even added, causing truncation.
|
|
27
27
|
|
|
28
28
|
---
|
|
29
29
|
|
|
@@ -21,7 +21,7 @@ This example shows one way to integrate **antigravity-awesome-skills** with a Je
|
|
|
21
21
|
- How to enforce a **maximum number of skills per turn** via `maxSkillsPerTurn`.
|
|
22
22
|
- How to choose whether to **truncate or error** when too many skills are requested via `overflowBehavior`.
|
|
23
23
|
|
|
24
|
-
This pattern avoids context overflow when you have 1,
|
|
24
|
+
This pattern avoids context overflow when you have 1,470+ skills installed.
|
|
25
25
|
|
|
26
26
|
Manifest contract references:
|
|
27
27
|
|
|
@@ -6,7 +6,7 @@ This document keeps the repository's GitHub-facing discovery copy aligned with t
|
|
|
6
6
|
|
|
7
7
|
Preferred positioning:
|
|
8
8
|
|
|
9
|
-
> Installable GitHub library of 1,
|
|
9
|
+
> Installable GitHub library of 1,470+ agentic skills for Claude Code, Cursor, Codex CLI, Gemini CLI, Antigravity, and other AI coding assistants.
|
|
10
10
|
|
|
11
11
|
Key framing:
|
|
12
12
|
|
|
@@ -20,7 +20,7 @@ Key framing:
|
|
|
20
20
|
|
|
21
21
|
Preferred description:
|
|
22
22
|
|
|
23
|
-
> Installable GitHub library of 1,
|
|
23
|
+
> Installable GitHub library of 1,470+ agentic skills for Claude Code, Cursor, Codex CLI, Gemini CLI, Antigravity, and more. Includes installer CLI, bundles, workflows, and official/community skill collections.
|
|
24
24
|
|
|
25
25
|
Preferred homepage:
|
|
26
26
|
|
|
@@ -28,7 +28,7 @@ Preferred homepage:
|
|
|
28
28
|
|
|
29
29
|
Preferred social preview:
|
|
30
30
|
|
|
31
|
-
- use a clean preview image that says `1,
|
|
31
|
+
- use a clean preview image that says `1,470+ Agentic Skills`;
|
|
32
32
|
- mention Claude Code, Cursor, Codex CLI, and Gemini CLI;
|
|
33
33
|
- avoid dense text and tiny logos that disappear in social cards.
|
|
34
34
|
|
|
@@ -72,7 +72,7 @@ The update process refreshes:
|
|
|
72
72
|
- Canonical skills index (`skills_index.json`)
|
|
73
73
|
- Compatibility mirror (`data/skills_index.json`)
|
|
74
74
|
- Web app skills data (`apps\web-app\public\skills.json`)
|
|
75
|
-
- All 1,
|
|
75
|
+
- All 1,470+ skills from the skills directory
|
|
76
76
|
|
|
77
77
|
## When to Update
|
|
78
78
|
|
|
@@ -12,7 +12,7 @@ Install the library into Claude Code, then invoke focused skills directly in the
|
|
|
12
12
|
|
|
13
13
|
## Why use this repo for Claude Code
|
|
14
14
|
|
|
15
|
-
- It includes 1,
|
|
15
|
+
- It includes 1,470+ skills instead of a narrow single-domain starter pack.
|
|
16
16
|
- It supports the standard `.claude/skills/` path and the Claude Code plugin marketplace flow.
|
|
17
17
|
- It also ships generated bundle plugins so teams can install focused packs like `Essentials` or `Security Developer` from the marketplace metadata.
|
|
18
18
|
- It includes onboarding docs, bundles, and workflows so new users do not need to guess where to begin.
|
|
@@ -12,7 +12,7 @@ Install into the Gemini skills path, then ask Gemini to apply one skill at a tim
|
|
|
12
12
|
|
|
13
13
|
- It installs directly into the expected Gemini skills path.
|
|
14
14
|
- It includes both core software engineering skills and deeper agent/LLM-oriented skills.
|
|
15
|
-
- It helps new users get started with bundles and workflows rather than forcing a cold start from 1,
|
|
15
|
+
- It helps new users get started with bundles and workflows rather than forcing a cold start from 1,470+ files.
|
|
16
16
|
- It is useful whether you want a broad internal skill library or a single repo to test many workflows quickly.
|
|
17
17
|
|
|
18
18
|
## Install Gemini CLI Skills
|
|
@@ -18,7 +18,7 @@ Kiro is AWS's agentic AI IDE that combines:
|
|
|
18
18
|
|
|
19
19
|
Kiro's agentic capabilities are enhanced by skills that provide:
|
|
20
20
|
|
|
21
|
-
- **Domain expertise** across 1,
|
|
21
|
+
- **Domain expertise** across 1,470+ specialized areas
|
|
22
22
|
- **Best practices** from Anthropic, OpenAI, Google, Microsoft, and AWS
|
|
23
23
|
- **Workflow automation** for common development tasks
|
|
24
24
|
- **AWS-specific patterns** for serverless, infrastructure, and cloud architecture
|
|
@@ -14,7 +14,7 @@ If you came in through a **Claude Code** or **Codex** plugin instead of a full l
|
|
|
14
14
|
|
|
15
15
|
When you ran `npx antigravity-awesome-skills` or cloned the repository, you:
|
|
16
16
|
|
|
17
|
-
✅ **Downloaded 1,
|
|
17
|
+
✅ **Downloaded 1,470+ skill files** to your computer (default: `~/.agents/skills/`; or a custom path like `~/.agent/skills/` if you used `--path`)
|
|
18
18
|
✅ **Made them available** to your AI assistant
|
|
19
19
|
❌ **Did NOT enable them all automatically** (they're just sitting there, waiting)
|
|
20
20
|
|
|
@@ -34,7 +34,7 @@ Bundles are **curated groups** of skills organized by role. They help you decide
|
|
|
34
34
|
|
|
35
35
|
**Analogy:**
|
|
36
36
|
|
|
37
|
-
- You installed a toolbox with 1,
|
|
37
|
+
- You installed a toolbox with 1,470+ tools (✅ done)
|
|
38
38
|
- Bundles are like **labeled organizer trays** saying: "If you're a carpenter, start with these 10 tools"
|
|
39
39
|
- You can either **pick skills from the tray** or install that tray as a focused marketplace bundle plugin
|
|
40
40
|
|
|
@@ -212,7 +212,7 @@ Let's actually use a skill right now. Follow these steps:
|
|
|
212
212
|
|
|
213
213
|
## Step 5: Picking Your First Skills (Practical Advice)
|
|
214
214
|
|
|
215
|
-
Don't try to use all 1,
|
|
215
|
+
Don't try to use all 1,470+ skills at once. Here's a sensible approach:
|
|
216
216
|
|
|
217
217
|
If you want a tool-specific starting point before choosing skills, use:
|
|
218
218
|
|
|
@@ -343,7 +343,7 @@ Usually no, but if your AI doesn't recognize a skill:
|
|
|
343
343
|
|
|
344
344
|
### "Can I load all skills into the model at once?"
|
|
345
345
|
|
|
346
|
-
No. Even though you have 1,
|
|
346
|
+
No. Even though you have 1,470+ skills installed locally, you should **not** concatenate every `SKILL.md` into a single system prompt or context block.
|
|
347
347
|
|
|
348
348
|
The intended pattern is:
|
|
349
349
|
|
|
@@ -34,7 +34,7 @@ antigravity-awesome-skills/
|
|
|
34
34
|
├── 📄 CONTRIBUTING.md ← Contributor workflow
|
|
35
35
|
├── 📄 CATALOG.md ← Full generated catalog
|
|
36
36
|
│
|
|
37
|
-
├── 📁 skills/ ← 1,
|
|
37
|
+
├── 📁 skills/ ← 1,470+ skills live here
|
|
38
38
|
│ │
|
|
39
39
|
│ ├── 📁 brainstorming/
|
|
40
40
|
│ │ └── 📄 SKILL.md ← Skill definition
|
|
@@ -47,7 +47,7 @@ antigravity-awesome-skills/
|
|
|
47
47
|
│ │ └── 📁 2d-games/
|
|
48
48
|
│ │ └── 📄 SKILL.md ← Nested skills also supported
|
|
49
49
|
│ │
|
|
50
|
-
│ └── ... (1,
|
|
50
|
+
│ └── ... (1,470+ total)
|
|
51
51
|
│
|
|
52
52
|
├── 📁 apps/
|
|
53
53
|
│ └── 📁 web-app/ ← Interactive browser
|
|
@@ -100,7 +100,7 @@ antigravity-awesome-skills/
|
|
|
100
100
|
|
|
101
101
|
```
|
|
102
102
|
┌─────────────────────────┐
|
|
103
|
-
│ 1,
|
|
103
|
+
│ 1,470+ SKILLS │
|
|
104
104
|
└────────────┬────────────┘
|
|
105
105
|
│
|
|
106
106
|
┌────────────────────────┼────────────────────────┐
|
|
@@ -201,7 +201,7 @@ If you want a workspace-style manual install instead, cloning into `.agent/skill
|
|
|
201
201
|
│ ├── 📁 brainstorming/ │
|
|
202
202
|
│ ├── 📁 stripe-integration/ │
|
|
203
203
|
│ ├── 📁 react-best-practices/ │
|
|
204
|
-
│ └── ... (1,
|
|
204
|
+
│ └── ... (1,470+ total) │
|
|
205
205
|
└─────────────────────────────────────────┘
|
|
206
206
|
```
|
|
207
207
|
|
|
@@ -0,0 +1,141 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: flowhunt-skill
|
|
3
|
+
description: "Automation discovery audit skill. Walks through a 5-question workflow intake, then audits Gmail/Calendar/Slack/task trackers to identify automation opportunities. Use when a user wants to discover what processes in their business can be automated."
|
|
4
|
+
category: automation
|
|
5
|
+
risk: safe
|
|
6
|
+
source: community
|
|
7
|
+
source_repo: heyneuron/flowhunt-skill
|
|
8
|
+
source_type: community
|
|
9
|
+
date_added: "2026-05-23"
|
|
10
|
+
author: heyneuron
|
|
11
|
+
tags: [automation, discovery, audit, gmail, calendar, slack, productivity, workflow]
|
|
12
|
+
tools: [claude, codex, gemini, cursor]
|
|
13
|
+
license: "MIT"
|
|
14
|
+
license_source: "https://github.com/heyneuron/flowhunt-skill/blob/main/LICENSE"
|
|
15
|
+
---
|
|
16
|
+
|
|
17
|
+
# FlowHunt Skill — Automation Discovery Audit
|
|
18
|
+
|
|
19
|
+
## Overview
|
|
20
|
+
|
|
21
|
+
FlowHunt is an automation discovery audit skill. It guides agents through a structured 5-question intake to understand the user's business context, then systematically audits connected tools (Gmail, Google Calendar, Slack, task trackers, and more) to surface concrete automation opportunities ranked by impact and effort.
|
|
22
|
+
|
|
23
|
+
The skill is cross-agent: it works with Claude Code, Codex CLI, Gemini CLI, OpenCode, and any agent that accepts markdown skill files.
|
|
24
|
+
|
|
25
|
+
Install: `npx skills add heyneuron/flowhunt-skill`
|
|
26
|
+
|
|
27
|
+
## When to Use This Skill
|
|
28
|
+
|
|
29
|
+
- Use when the user asks "what can I automate in my business?"
|
|
30
|
+
- Use when the user wants a workflow audit across Gmail, Calendar, Slack, or task tools
|
|
31
|
+
- Use when starting an automation engagement and need structured discovery before recommending solutions
|
|
32
|
+
- Use when the user says "show me automation opportunities" or "FlowHunt"
|
|
33
|
+
|
|
34
|
+
## How It Works
|
|
35
|
+
|
|
36
|
+
### Step 1: Intake — 5-Question Workflow Questionnaire
|
|
37
|
+
|
|
38
|
+
Ask the user exactly these five questions, one at a time:
|
|
39
|
+
|
|
40
|
+
1. **Role & team size** — What is your role, and how many people are on your team?
|
|
41
|
+
2. **Top 3 repetitive tasks** — What are the three most repetitive tasks you or your team do every week?
|
|
42
|
+
3. **Connected tools** — Which tools do you actively use? (Gmail, Google Calendar, Slack, Notion, Jira, Asana, HubSpot, etc.)
|
|
43
|
+
4. **Pain point** — Which of those repetitive tasks costs you the most time or causes the most errors?
|
|
44
|
+
5. **Automation goal** — Are you looking to save time, reduce errors, or hand off tasks entirely?
|
|
45
|
+
|
|
46
|
+
Wait for answers before moving to the audit.
|
|
47
|
+
|
|
48
|
+
### Step 2: Audit — Scan Connected Tools
|
|
49
|
+
|
|
50
|
+
For each tool the user mentioned, surface automation patterns:
|
|
51
|
+
|
|
52
|
+
**Gmail**
|
|
53
|
+
- Auto-labeling and routing rules
|
|
54
|
+
- Draft generation for recurring email types
|
|
55
|
+
- Invoice / attachment extraction to Drive or Notion
|
|
56
|
+
- Follow-up reminders when no reply received
|
|
57
|
+
|
|
58
|
+
**Google Calendar**
|
|
59
|
+
- Meeting prep summaries (agenda + attendee context) sent automatically
|
|
60
|
+
- Booking link workflows with intake forms
|
|
61
|
+
- Post-meeting action item extraction
|
|
62
|
+
|
|
63
|
+
**Slack**
|
|
64
|
+
- Daily standup collection → summary to channel or doc
|
|
65
|
+
- Keyword alerts routed to the right person
|
|
66
|
+
- Approval workflows with emoji reactions
|
|
67
|
+
|
|
68
|
+
**Task trackers (Asana, Jira, Notion, Linear)**
|
|
69
|
+
- Auto-create tasks from emails or Slack messages
|
|
70
|
+
- Status update reminders
|
|
71
|
+
- Weekly digest of overdue or blocked items
|
|
72
|
+
|
|
73
|
+
**CRMs (HubSpot, Salesforce, Pipedrive)**
|
|
74
|
+
- Lead scoring and routing rules
|
|
75
|
+
- Follow-up sequences triggered by deal stage change
|
|
76
|
+
- Contact enrichment on new lead creation
|
|
77
|
+
|
|
78
|
+
### Step 3: Prioritization Matrix
|
|
79
|
+
|
|
80
|
+
Rank each identified opportunity on a 2x2:
|
|
81
|
+
|
|
82
|
+
| | Low effort | High effort |
|
|
83
|
+
|---|---|---|
|
|
84
|
+
| **High impact** | Do first (quick wins) | Plan carefully |
|
|
85
|
+
| **Low impact** | Nice to have | Skip for now |
|
|
86
|
+
|
|
87
|
+
Present the top 3 quick-win automations with:
|
|
88
|
+
- What it does
|
|
89
|
+
- Which tools it connects
|
|
90
|
+
- Estimated time saved per week
|
|
91
|
+
- Suggested implementation path (Zapier / Make / n8n / custom code)
|
|
92
|
+
|
|
93
|
+
### Step 4: Output
|
|
94
|
+
|
|
95
|
+
Deliver a structured Automation Opportunity Report in markdown:
|
|
96
|
+
|
|
97
|
+
```
|
|
98
|
+
# Automation Opportunity Report
|
|
99
|
+
|
|
100
|
+
## Business Context
|
|
101
|
+
[Summary from intake]
|
|
102
|
+
|
|
103
|
+
## Top 3 Quick Wins
|
|
104
|
+
1. [Name] — [What it does] — [Tools] — [~X hrs/week saved]
|
|
105
|
+
2. ...
|
|
106
|
+
3. ...
|
|
107
|
+
|
|
108
|
+
## Full Opportunity List
|
|
109
|
+
[All identified automations, ranked]
|
|
110
|
+
|
|
111
|
+
## Recommended Next Step
|
|
112
|
+
[Single clearest action the user can take today]
|
|
113
|
+
```
|
|
114
|
+
|
|
115
|
+
## Common Rationalizations to Reject
|
|
116
|
+
|
|
117
|
+
| Excuse | Why it's wrong |
|
|
118
|
+
|--------|----------------|
|
|
119
|
+
| "I'll skip the intake and guess their stack" | Intake prevents wasted recommendations on tools they don't use |
|
|
120
|
+
| "I'll list every possible automation" | Overwhelming output kills adoption — prioritize ruthlessly |
|
|
121
|
+
| "I'll recommend complex custom code first" | Start with no-code/low-code quick wins; earn the right to build |
|
|
122
|
+
|
|
123
|
+
## Red Flags
|
|
124
|
+
|
|
125
|
+
- User has no clear repetitive task → dig deeper, they always exist
|
|
126
|
+
- Recommending automations for tools the user didn't mention → stay scoped
|
|
127
|
+
- Skipping the prioritization matrix → every opportunity looks equal without it
|
|
128
|
+
|
|
129
|
+
## Limitations
|
|
130
|
+
|
|
131
|
+
- This skill identifies and prioritizes automation opportunities; it does not implement the automations for the user.
|
|
132
|
+
- Tool audits depend on the user's stated stack and any explicitly connected data sources; do not assume access to Gmail, Calendar, Slack, CRMs, or task trackers.
|
|
133
|
+
- Time-saved estimates are directional planning aids, not guaranteed outcomes.
|
|
134
|
+
|
|
135
|
+
## Verification
|
|
136
|
+
|
|
137
|
+
The skill is complete when the user has:
|
|
138
|
+
- [ ] Answered all 5 intake questions
|
|
139
|
+
- [ ] Received a ranked list of automation opportunities
|
|
140
|
+
- [ ] Identified at least one quick-win automation they can start this week
|
|
141
|
+
- [ ] A clear recommended next step
|
|
@@ -0,0 +1,173 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: geminiignore-finops
|
|
3
|
+
description: "Configure and optimize .geminiignore files for AI context window efficiency and token cost reduction (FinOps)."
|
|
4
|
+
category: context-optimization
|
|
5
|
+
risk: safe
|
|
6
|
+
source: community
|
|
7
|
+
source_repo: iradoweck/antigravity-awesome-skills
|
|
8
|
+
source_type: community
|
|
9
|
+
date_added: "2026-05-25"
|
|
10
|
+
author: iradoweck
|
|
11
|
+
tags: [finops, context-management, token-optimization, geminiignore]
|
|
12
|
+
tools: [gemini, claude, cursor]
|
|
13
|
+
license: "MIT"
|
|
14
|
+
license_source: "https://github.com/iradoweck/antigravity-awesome-skills/blob/main/LICENSE"
|
|
15
|
+
---
|
|
16
|
+
|
|
17
|
+
# GeminiIgnore FinOps Setup & Optimization
|
|
18
|
+
|
|
19
|
+
## Overview
|
|
20
|
+
|
|
21
|
+
A skill to construct, refine, and maintain high-performance `.geminiignore` files across diverse tech stacks. By filtering out machine-generated code, heavy logs, package locks, and binary assets, this skill optimizes the AI agent's context window, accelerates processing speed, and reduces token consumption costs (FinOps).
|
|
22
|
+
|
|
23
|
+
## When to Use This Skill
|
|
24
|
+
|
|
25
|
+
- Use when initializing a new repository or workspace for pair-programming with AI agents.
|
|
26
|
+
- Use when the AI context window is reaching its limits or when billing optimization (FinOps) is a priority.
|
|
27
|
+
- Use when the AI agent is accidentally reading build outputs, lock files, databases, or binary media.
|
|
28
|
+
|
|
29
|
+
## How It Works
|
|
30
|
+
|
|
31
|
+
### Step 1: Analyze the Workspace Tech Stack
|
|
32
|
+
Detect the languages, frameworks, and dependency managers present in the project (e.g., Node.js, Python, PHP, Dart/Flutter, Rust).
|
|
33
|
+
|
|
34
|
+
### Step 2: Initialize or Update the `.geminiignore` File
|
|
35
|
+
Create a `.geminiignore` file at the root of the active workspace. If one already exists, review it to add missing categories.
|
|
36
|
+
|
|
37
|
+
### Step 3: Implement the 7 Core Rules
|
|
38
|
+
Add rules divided into the following categories to filter out unnecessary machine noise while keeping human-written code visible:
|
|
39
|
+
|
|
40
|
+
1. **System & Editor Noise**: Block OS temp files (`.DS_Store`, `Thumbs.db`) and user-specific IDE caches (`.idea/`, `.vscode/*`, Xcode user data).
|
|
41
|
+
2. **Dependency Folders & Lock Files**: Ignore third-party package directories (`node_modules/`, `vendor/`) and giant machine-generated lock files (`package-lock.json`, `yarn.lock`, `Cargo.lock`, `composer.lock`).
|
|
42
|
+
3. **Build & Target Output**: Block compiled folders (`dist/`, `build/`, `.next/`, `.nuxt/`).
|
|
43
|
+
4. **Caches & Tool Metadata**: Block compiler caches (`.tsbuildinfo`, `.vite/`, `.pytest_cache/`, `.eslintcache`).
|
|
44
|
+
5. **Binary & Rich Assets**: Block media types (`*.png`, `*.pdf`, `*.mp4`, `*.woff2`) to prevent triggering expensive vision/multimodal tokens.
|
|
45
|
+
6. **Local Databases & Logs**: Block log files (`*.log`) and SQL dumps or local SQLite DBs (`*.sqlite`, `*.db`).
|
|
46
|
+
7. **Compiled Binaries & Mobile Builds**: Block mobile package files (`*.apk`, `*.ipa`) and compiled binaries (`*.class`, `*.pyc`, `*.dll`).
|
|
47
|
+
|
|
48
|
+
### Step 4: Validate Exclusions
|
|
49
|
+
Verify that the AI can still see critical configuration blueprints (like `.env.example`, `package.json`, `composer.json`, `pyproject.toml`) but ignores the actual `.env` files and compilation artifacts.
|
|
50
|
+
|
|
51
|
+
## Examples
|
|
52
|
+
|
|
53
|
+
### Example 1: Standard Universal `.geminiignore` Template
|
|
54
|
+
|
|
55
|
+
Here is a recommended baseline configuration for a multi-language project:
|
|
56
|
+
|
|
57
|
+
```ini
|
|
58
|
+
# ==============================================================================
|
|
59
|
+
# .geminiignore - BASELINE DE FINOPS E ARQUITETURA
|
|
60
|
+
# ==============================================================================
|
|
61
|
+
|
|
62
|
+
# 1. SISTEMA OPERACIONAL E IDEs
|
|
63
|
+
.DS_Store
|
|
64
|
+
Thumbs.db
|
|
65
|
+
Desktop.ini
|
|
66
|
+
$RECYCLE.BIN/
|
|
67
|
+
.vscode/*
|
|
68
|
+
!.vscode/settings.json
|
|
69
|
+
!.vscode/tasks.json
|
|
70
|
+
!.vscode/launch.json
|
|
71
|
+
.idea/
|
|
72
|
+
*.iml
|
|
73
|
+
.gradle/
|
|
74
|
+
local.properties
|
|
75
|
+
.history/
|
|
76
|
+
|
|
77
|
+
# 2. DEPENDÊNCIAS (ECONOMIA DE TOKENS EM LOCK FILES)
|
|
78
|
+
node_modules/
|
|
79
|
+
package-lock.json
|
|
80
|
+
yarn.lock
|
|
81
|
+
pnpm-lock.yaml
|
|
82
|
+
vendor/
|
|
83
|
+
composer.lock
|
|
84
|
+
venv/
|
|
85
|
+
.venv/
|
|
86
|
+
env/
|
|
87
|
+
.env
|
|
88
|
+
.env.*
|
|
89
|
+
!.env.example
|
|
90
|
+
poetry.lock
|
|
91
|
+
Cargo.lock
|
|
92
|
+
pubspec.lock
|
|
93
|
+
|
|
94
|
+
# 3. BUILDS E EXPORTAÇÕES
|
|
95
|
+
dist/
|
|
96
|
+
build/
|
|
97
|
+
out/
|
|
98
|
+
target/
|
|
99
|
+
.next/
|
|
100
|
+
.nuxt/
|
|
101
|
+
.output/
|
|
102
|
+
bin/
|
|
103
|
+
obj/
|
|
104
|
+
|
|
105
|
+
# 4. CACHES DE FRAMEWORKS
|
|
106
|
+
.vite/
|
|
107
|
+
.parcel-cache/
|
|
108
|
+
.eslintcache
|
|
109
|
+
.babel-cache/
|
|
110
|
+
.tsbuildinfo
|
|
111
|
+
.turbo/
|
|
112
|
+
.pytest_cache/
|
|
113
|
+
.ruff_cache/
|
|
114
|
+
storage/framework/
|
|
115
|
+
storage/logs/
|
|
116
|
+
|
|
117
|
+
# 5. ASSETS BINÁRIOS E MULTIMÍDIA EXTREMOS
|
|
118
|
+
*.png
|
|
119
|
+
*.jpg
|
|
120
|
+
*.jpeg
|
|
121
|
+
*.gif
|
|
122
|
+
*.webp
|
|
123
|
+
*.svg
|
|
124
|
+
*.ico
|
|
125
|
+
*.psd
|
|
126
|
+
*.fig
|
|
127
|
+
*.pdf
|
|
128
|
+
*.zip
|
|
129
|
+
*.tar.gz
|
|
130
|
+
*.woff
|
|
131
|
+
*.woff2
|
|
132
|
+
*.ttf
|
|
133
|
+
|
|
134
|
+
# 6. BANCOS DE DADOS E LOGS
|
|
135
|
+
*.log
|
|
136
|
+
*.db
|
|
137
|
+
*.sqlite
|
|
138
|
+
*.sqlite3
|
|
139
|
+
*.sql
|
|
140
|
+
*.sql.gz
|
|
141
|
+
|
|
142
|
+
# 7. ARQUIVOS COMPILADOS
|
|
143
|
+
*.apk
|
|
144
|
+
*.aab
|
|
145
|
+
*.ipa
|
|
146
|
+
*.jar
|
|
147
|
+
*.class
|
|
148
|
+
*.pyc
|
|
149
|
+
__pycache__/
|
|
150
|
+
*.so
|
|
151
|
+
*.dylib
|
|
152
|
+
*.dll
|
|
153
|
+
*.exe
|
|
154
|
+
*.js.map
|
|
155
|
+
*.css.map
|
|
156
|
+
```
|
|
157
|
+
|
|
158
|
+
## Best Practices
|
|
159
|
+
|
|
160
|
+
- ✅ **Ignore dependency lock files**: Standard lock files (e.g., `package-lock.json`, `yarn.lock`) contain thousands of lines of redundant package resolution trees. Ignoring them is the single largest FinOps win.
|
|
161
|
+
- ✅ **Keep configurations visible**: Ensure manifests like `package.json`, `composer.json`, `Cargo.toml`, and `pyproject.toml` are NEVER ignored, as the AI needs them to understand dependencies.
|
|
162
|
+
- ✅ **Whitelist config examples**: Use rules like `!.env.example` alongside `.env` ignores so the AI understands configuration structure without exposing credentials.
|
|
163
|
+
- ❌ **Do not ignore source code**: Avoid overly broad folder patterns like `lib/` or `app/` if they contain primary source code. Be specific (e.g., block `vendor/bundle/` but not your actual code).
|
|
164
|
+
|
|
165
|
+
## Limitations
|
|
166
|
+
|
|
167
|
+
- A `.geminiignore` file only affects AI tools parsing the workspace; it does not replace `.gitignore` for Git repository hosting.
|
|
168
|
+
- Patterns must be formatted correctly according to gitignore-style globbing to avoid accidentally ignoring source files.
|
|
169
|
+
|
|
170
|
+
## Related Skills
|
|
171
|
+
|
|
172
|
+
- `@context-optimization` - Broad tactics for context window management.
|
|
173
|
+
- `@clean-code` - Architectural practices for clean, human-readable codebases.
|
|
@@ -0,0 +1,110 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: ii-commons
|
|
3
|
+
description: "Deterministic search across arXiv, PubMed/PMC, and US policy corpora with daily freshness cutoffs."
|
|
4
|
+
category: research
|
|
5
|
+
risk: safe
|
|
6
|
+
source: community
|
|
7
|
+
source_repo: Intelligent-Internet/II-Commons-Skills
|
|
8
|
+
source_type: community
|
|
9
|
+
date_added: "2026-05-26"
|
|
10
|
+
author: Intelligent Internet
|
|
11
|
+
tags: [research, arxiv, pubmed, pmc, policy, retrieval, cli, codex]
|
|
12
|
+
tools: [claude, cursor, gemini, codex, antigravity]
|
|
13
|
+
license: "Apache-2.0"
|
|
14
|
+
license_source: "https://github.com/Intelligent-Internet/II-Commons-Skills/blob/main/LICENSE"
|
|
15
|
+
---
|
|
16
|
+
|
|
17
|
+
# II-Commons
|
|
18
|
+
|
|
19
|
+
## Overview
|
|
20
|
+
|
|
21
|
+
II-Commons provides deterministic retrieval for research agents across arXiv, PubMed/PMC, and supported US policy corpora. Use it when a task needs reproducible search, metadata lookup, full-document Markdown retrieval, or a freshness check before answering with recent evidence.
|
|
22
|
+
|
|
23
|
+
The upstream project publishes a Node.js CLI as `@intelligentinternet/ii-commons` and a full agent skill at `skills/ii-commons/`.
|
|
24
|
+
|
|
25
|
+
## When to Use This Skill
|
|
26
|
+
|
|
27
|
+
- Use when searching arXiv, PubMed/PMC, or supported US policy corpora for evidence.
|
|
28
|
+
- Use when the user asks for latest or recent research and corpus freshness matters.
|
|
29
|
+
- Use when you need stable identifiers, metadata, or full-document Markdown for downstream analysis.
|
|
30
|
+
- Use when comparing evidence across scientific literature and policy documents.
|
|
31
|
+
|
|
32
|
+
## How It Works
|
|
33
|
+
|
|
34
|
+
### Step 1: Check Corpus Freshness
|
|
35
|
+
|
|
36
|
+
Run `cutoff` before freshness-sensitive searches:
|
|
37
|
+
|
|
38
|
+
```bash
|
|
39
|
+
npx @intelligentinternet/ii-commons cutoff
|
|
40
|
+
```
|
|
41
|
+
|
|
42
|
+
Report the relevant cutoff date before interpreting recent results.
|
|
43
|
+
|
|
44
|
+
### Step 2: Search the Right Corpus
|
|
45
|
+
|
|
46
|
+
Use exactly this command shape:
|
|
47
|
+
|
|
48
|
+
```bash
|
|
49
|
+
npx @intelligentinternet/ii-commons search arxiv "large language model inference" --max-results 10
|
|
50
|
+
npx @intelligentinternet/ii-commons search pubmed "type 2 diabetes review" --start 20240000 --max-results 10
|
|
51
|
+
npx @intelligentinternet/ii-commons search policy "state overtime rule for agricultural workers" --jurisdictions US-CA --max-results 10
|
|
52
|
+
```
|
|
53
|
+
|
|
54
|
+
Choose `arxiv` for preprints and technical research, `pubmed` for biomedical and clinical literature, and `policy` for supported US policy corpora.
|
|
55
|
+
|
|
56
|
+
### Step 3: Retrieve Metadata or Markdown
|
|
57
|
+
|
|
58
|
+
Use stable identifiers from search results:
|
|
59
|
+
|
|
60
|
+
```bash
|
|
61
|
+
npx @intelligentinternet/ii-commons meta "arXiv:2402.03578"
|
|
62
|
+
npx @intelligentinternet/ii-commons markdown "PMCID:PMC11152602"
|
|
63
|
+
```
|
|
64
|
+
|
|
65
|
+
Build summaries from search results first, then request Markdown when detailed inspection or full-document grounding is needed.
|
|
66
|
+
|
|
67
|
+
## Installation
|
|
68
|
+
|
|
69
|
+
Run the CLI with `npx`:
|
|
70
|
+
|
|
71
|
+
```bash
|
|
72
|
+
npx @intelligentinternet/ii-commons --help
|
|
73
|
+
```
|
|
74
|
+
|
|
75
|
+
Or install globally:
|
|
76
|
+
|
|
77
|
+
```bash
|
|
78
|
+
npm install -g @intelligentinternet/ii-commons
|
|
79
|
+
ii-commons cutoff
|
|
80
|
+
```
|
|
81
|
+
|
|
82
|
+
To install the full upstream agent skill, install the `skills/ii-commons/` folder from:
|
|
83
|
+
|
|
84
|
+
```text
|
|
85
|
+
https://github.com/Intelligent-Internet/II-Commons-Skills
|
|
86
|
+
```
|
|
87
|
+
|
|
88
|
+
## Best Practices
|
|
89
|
+
|
|
90
|
+
- Prefer server-side date filters such as `--start` and `--end` for time-bounded arXiv and PubMed searches.
|
|
91
|
+
- Preserve canonical identifiers such as `arXiv:<id>`, `PMID:<id>`, `PMCID:PMC<id>`, and `policy:<jurisdiction>:<id>`.
|
|
92
|
+
- Use `cutoff` as the authoritative freshness boundary for each corpus.
|
|
93
|
+
- Keep non-time filters conservative until initial search results show the right scope.
|
|
94
|
+
|
|
95
|
+
## Limitations
|
|
96
|
+
|
|
97
|
+
- Requires Node.js 18 or newer and outbound network access to `commons.ii.inc`.
|
|
98
|
+
- Basic usage works without authentication; higher usage limits may require an API token from `https://commons.ii.inc/`.
|
|
99
|
+
- Supported policy coverage is limited to the policy corpora exposed by II-Commons.
|
|
100
|
+
|
|
101
|
+
## Security & Safety Notes
|
|
102
|
+
|
|
103
|
+
- Do not print or expose `II_COMMONS_API_KEY` values.
|
|
104
|
+
- Treat outputs as retrieval evidence, not expert review. For medical, legal, or policy-sensitive work, cite sources and preserve uncertainty.
|
|
105
|
+
- Commands call an external API service; confirm network access is allowed in the user's environment before running them.
|
|
106
|
+
|
|
107
|
+
## Related Skills
|
|
108
|
+
|
|
109
|
+
- Use broader web-search or deep-research skills when evidence is outside arXiv, PubMed/PMC, or supported policy corpora.
|
|
110
|
+
- Use citation-management skills after II-Commons has identified stable source records.
|
|
@@ -0,0 +1,161 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: mesh-memory
|
|
3
|
+
description: "Self-hosted semantic memory for AI agents via MCP. Save worklogs, decisions, and notes, then recall them across sessions by meaning, not keyword. Postgres + pgvector with auto-tagging."
|
|
4
|
+
risk: safe
|
|
5
|
+
source: dklymentiev/mesh-memory (MIT)
|
|
6
|
+
date_added: "2026-05-23"
|
|
7
|
+
---
|
|
8
|
+
|
|
9
|
+
# Mesh Memory
|
|
10
|
+
|
|
11
|
+
Mesh Memory is a self-hosted semantic memory service with a built-in MCP server. It stores documents (worklogs, decisions, notes, research) in PostgreSQL with pgvector and retrieves them by meaning, so a query like "what database did we pick?" surfaces a saved note that says "chose Redis for caching" even with zero keyword overlap. Embeddings are generated locally with `multilingual-e5-base` (768 dimensions); the core flow requires no external API keys.
|
|
12
|
+
|
|
13
|
+
Use this skill when an agent needs persistent memory across sessions: saving its own work, recalling prior decisions, or building a project knowledge base shared between multiple agents.
|
|
14
|
+
|
|
15
|
+
## When to Use This Skill
|
|
16
|
+
|
|
17
|
+
- Saving a session worklog, decision, or research note so a later session can find it.
|
|
18
|
+
- Recalling past work by topic when you do not remember the exact words you used.
|
|
19
|
+
- Sharing a long-lived knowledge base across multiple agents, terminals, or teammates.
|
|
20
|
+
- Organizing context by role or project through workspaces (one workspace per role/project).
|
|
21
|
+
- Looking up structured tags (e.g. all `type:decision` entries from one project).
|
|
22
|
+
|
|
23
|
+
## Prerequisites
|
|
24
|
+
|
|
25
|
+
- A running Mesh Memory instance reachable from the MCP server. Local Docker is the common path -- `docker compose up -d` in the upstream repo brings it up; see https://github.com/dklymentiev/mesh-memory for the full Quick Start.
|
|
26
|
+
- The MCP server (`mcp_server.py`) registered with your client (Claude Code, Cursor, Claude Desktop, or any other MCP-aware agent).
|
|
27
|
+
- `MESH_API_URL` pointing at the running instance (default: `http://localhost:8000`).
|
|
28
|
+
|
|
29
|
+
## Setup
|
|
30
|
+
|
|
31
|
+
Register the MCP server in your client configuration:
|
|
32
|
+
|
|
33
|
+
```json
|
|
34
|
+
{
|
|
35
|
+
"mcpServers": {
|
|
36
|
+
"mesh": {
|
|
37
|
+
"command": "python3",
|
|
38
|
+
"args": ["/path/to/mesh-memory/mcp_server.py"],
|
|
39
|
+
"env": {
|
|
40
|
+
"MESH_API_URL": "http://localhost:8000"
|
|
41
|
+
}
|
|
42
|
+
}
|
|
43
|
+
}
|
|
44
|
+
}
|
|
45
|
+
```
|
|
46
|
+
|
|
47
|
+
When the server is reachable, the 13 tools listed below become available.
|
|
48
|
+
|
|
49
|
+
## MCP Tools
|
|
50
|
+
|
|
51
|
+
| Tool | Purpose |
|
|
52
|
+
|------|---------|
|
|
53
|
+
| `mesh_focus` | Switch the active workspace (optionally prefetch recent docs). |
|
|
54
|
+
| `mesh_add` | Save a document with optional tags. Auto-adds `date:YYYY-MM-DD` and `source:`. |
|
|
55
|
+
| `mesh_update` | Update content, tags, or pinned status of an existing document. |
|
|
56
|
+
| `mesh_delete` | Delete a document by GUID. |
|
|
57
|
+
| `mesh_get` | Fetch a single document by GUID. |
|
|
58
|
+
| `mesh_search` | Semantic search by query, optionally across multiple workspaces with weights. |
|
|
59
|
+
| `mesh_bytag` | List documents that match one or more tags (AND logic). |
|
|
60
|
+
| `mesh_recent` | List most recently created documents, optionally filtered by `type:` tag. |
|
|
61
|
+
| `mesh_projects` | List per-project document counts (uses `guid:` tag as project marker). |
|
|
62
|
+
| `mesh_tags` | List existing tags with counts; optional prefix filter. |
|
|
63
|
+
| `mesh_versions` | Show the version chain of a document (similarity-linked revisions). |
|
|
64
|
+
| `mesh_stats` | Memory statistics for the active workspace. |
|
|
65
|
+
| `mesh_schema` | Show the tag schema (recognized prefixes and types). |
|
|
66
|
+
|
|
67
|
+
## Workflows
|
|
68
|
+
|
|
69
|
+
### Save a session worklog
|
|
70
|
+
|
|
71
|
+
After completing work, persist it for future sessions:
|
|
72
|
+
|
|
73
|
+
```
|
|
74
|
+
mesh_add(
|
|
75
|
+
content="Investigated 502s on the checkout flow. Root cause: missing CORS header on the cart API. Fix shipped in commit abc123.",
|
|
76
|
+
tags="type:worklog,topic:checkout,date:2026-05-23",
|
|
77
|
+
workspace="developer"
|
|
78
|
+
)
|
|
79
|
+
```
|
|
80
|
+
|
|
81
|
+
`date:` and `source:` are added automatically when omitted. Type and topic tags are inferred from nearest neighbors after the embedding completes (5-10 seed documents required before inference kicks in).
|
|
82
|
+
|
|
83
|
+
### Recall past work by meaning
|
|
84
|
+
|
|
85
|
+
Search across sessions for related context, even with different vocabulary:
|
|
86
|
+
|
|
87
|
+
```
|
|
88
|
+
mesh_search(query="checkout was failing for some users", limit=5, workspace="developer")
|
|
89
|
+
```
|
|
90
|
+
|
|
91
|
+
The query shares no keywords with the original note ("502s", "CORS"), but the embedding-based search surfaces it.
|
|
92
|
+
|
|
93
|
+
### Switch role / context
|
|
94
|
+
|
|
95
|
+
For a multi-role agent, switch the active workspace at the start of a session:
|
|
96
|
+
|
|
97
|
+
```
|
|
98
|
+
mesh_focus(workspace="sysadmin", prefetch=true, limit=5)
|
|
99
|
+
```
|
|
100
|
+
|
|
101
|
+
Subsequent calls default to that workspace. Pin a role-prompt document at the top of each workspace so the agent re-orients on every prefetch.
|
|
102
|
+
|
|
103
|
+
### Cross-workspace search with weights
|
|
104
|
+
|
|
105
|
+
To pull context from related domains without diluting the primary signal:
|
|
106
|
+
|
|
107
|
+
```
|
|
108
|
+
mesh_search(
|
|
109
|
+
query="nginx rate limit recipe",
|
|
110
|
+
workspaces={"sysadmin": 0.7, "security": 0.2, "developer": 0.1},
|
|
111
|
+
limit=10
|
|
112
|
+
)
|
|
113
|
+
```
|
|
114
|
+
|
|
115
|
+
Results are merged across workspaces and re-scored by workspace weight.
|
|
116
|
+
|
|
117
|
+
### Structured lookups by tag
|
|
118
|
+
|
|
119
|
+
When you need an exact filter rather than semantic similarity:
|
|
120
|
+
|
|
121
|
+
```
|
|
122
|
+
mesh_bytag(tags="type:decision,status:active,guid:my-project", limit=20)
|
|
123
|
+
```
|
|
124
|
+
|
|
125
|
+
## Tag Conventions
|
|
126
|
+
|
|
127
|
+
Mesh accepts arbitrary tags. The recommended prefixes (used by auto-inference and surfaced by `mesh_schema`):
|
|
128
|
+
|
|
129
|
+
| Prefix | Meaning |
|
|
130
|
+
|--------|---------|
|
|
131
|
+
| `type:worklog` | Completed work; the most common type. |
|
|
132
|
+
| `type:note` | Quick notes, observations. |
|
|
133
|
+
| `type:decision` | Architecture or product decisions. |
|
|
134
|
+
| `type:research` | Investigation results, findings. |
|
|
135
|
+
| `type:task` | Action items. |
|
|
136
|
+
| `type:rfc` | Proposals for review. |
|
|
137
|
+
| `status:active` / `status:completed` / `status:archived` | Lifecycle. |
|
|
138
|
+
| `date:YYYY-MM-DD` | When the document was created (auto-added). |
|
|
139
|
+
| `source:` | How the document arrived (auto-added: `mcp`, `api`, etc.). |
|
|
140
|
+
| `guid:<project-id>` | Project marker -- use a consistent slug across all docs of a project. |
|
|
141
|
+
|
|
142
|
+
With fewer than ~5-10 documents in a workspace, neighbor inference is skipped; manually tag seed documents until the corpus self-organizes.
|
|
143
|
+
|
|
144
|
+
## Troubleshooting
|
|
145
|
+
|
|
146
|
+
**Tool calls fail with connection errors.** The MCP server cannot reach `MESH_API_URL`. Verify the instance is up (`curl $MESH_API_URL/health` returns `{"status":"healthy"}`) and the env var is set in the MCP config.
|
|
147
|
+
|
|
148
|
+
**A saved document does not appear in semantic search yet.** Embedding generation runs in the background. After a save, expect a 1-2 second delay before semantic search hits the new document. `mesh_get(guid=...)` confirms the document exists immediately.
|
|
149
|
+
|
|
150
|
+
**Search returns results from the wrong domain.** The active workspace is not what you expected. Call `mesh_focus(workspace="<name>")` explicitly, or pass `workspace=` on every call. With no focus and no explicit param, calls land in the `default` workspace.
|
|
151
|
+
|
|
152
|
+
**Auto-tagging never adds anything.** The workspace has too few documents for neighbor inference (~5-10 minimum). Manually tag a handful of seed documents, then auto-inference takes over.
|
|
153
|
+
|
|
154
|
+
**A deleted document still appears in a search result.** Embedding indices are eventually consistent; rerun the search after a few seconds, or use `mesh_get(guid=...)` to confirm deletion.
|
|
155
|
+
|
|
156
|
+
## Limitations
|
|
157
|
+
|
|
158
|
+
- Mesh is a knowledge store, not a chat memory. Long conversation transcripts should be summarized before being saved.
|
|
159
|
+
- Vector similarity is robust but not perfect; for high-precision structured lookups, prefer `mesh_bytag` over `mesh_search`.
|
|
160
|
+
- Embeddings run on CPU by default; very large corpora (hundreds of thousands of documents) benefit from a dedicated instance and pgvector tuning, not covered here.
|
|
161
|
+
- The optional AI categorizer requires an OpenAI-compatible LLM endpoint and is disabled by default.
|
|
@@ -0,0 +1,107 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: socialclaw
|
|
3
|
+
description: "Agent-first social media publishing skill — schedule and publish posts across 13 platforms (X, LinkedIn, Instagram, Facebook Pages, TikTok, Discord, Telegram, YouTube, Reddit, WordPress, Pinterest) via a single workspace API key."
|
|
4
|
+
category: marketing
|
|
5
|
+
risk: safe
|
|
6
|
+
source: community
|
|
7
|
+
source_repo: ndesv21/socialclaw
|
|
8
|
+
source_type: community
|
|
9
|
+
date_added: "2026-05-25"
|
|
10
|
+
author: ndesv21
|
|
11
|
+
tags: [social-media, publishing, scheduling, marketing, twitter, linkedin, instagram, tiktok, discord, telegram, reddit, wordpress, pinterest]
|
|
12
|
+
tools: [claude]
|
|
13
|
+
license: "MIT"
|
|
14
|
+
license_source: "https://github.com/ndesv21/socialclaw/blob/main/LICENSE"
|
|
15
|
+
---
|
|
16
|
+
|
|
17
|
+
# SocialClaw — Social Media Publisher
|
|
18
|
+
|
|
19
|
+
## Overview
|
|
20
|
+
|
|
21
|
+
SocialClaw is an agent-first social media publishing skill that lets you schedule and publish posts across 13 platforms using a single workspace API key. No per-platform OAuth setup required — one key covers everything.
|
|
22
|
+
|
|
23
|
+
## When to Use
|
|
24
|
+
|
|
25
|
+
- Use when the user wants to plan, schedule, or publish a social media campaign across multiple platforms.
|
|
26
|
+
- Use when the user has a SocialClaw workspace API key and wants one workflow for X, LinkedIn, Instagram, Facebook, TikTok, Discord, Telegram, YouTube, Reddit, WordPress, or Pinterest.
|
|
27
|
+
- Use when the user asks for social publishing automation that can validate schedules, attach media, and retrieve post performance metrics.
|
|
28
|
+
|
|
29
|
+
## Supported Platforms
|
|
30
|
+
|
|
31
|
+
- X (Twitter)
|
|
32
|
+
- LinkedIn (Profile + Page)
|
|
33
|
+
- Instagram (Business + Standalone)
|
|
34
|
+
- Facebook Pages
|
|
35
|
+
- TikTok
|
|
36
|
+
- Discord
|
|
37
|
+
- Telegram
|
|
38
|
+
- YouTube
|
|
39
|
+
- Reddit
|
|
40
|
+
- WordPress
|
|
41
|
+
- Pinterest
|
|
42
|
+
|
|
43
|
+
## Installation
|
|
44
|
+
|
|
45
|
+
```bash
|
|
46
|
+
npx skills add ndesv21/socialclaw
|
|
47
|
+
```
|
|
48
|
+
|
|
49
|
+
Or install the npm package directly:
|
|
50
|
+
|
|
51
|
+
```bash
|
|
52
|
+
npm install socialclaw@0.1.12
|
|
53
|
+
```
|
|
54
|
+
|
|
55
|
+
## Configuration
|
|
56
|
+
|
|
57
|
+
Set your workspace API key:
|
|
58
|
+
|
|
59
|
+
```bash
|
|
60
|
+
export SOCIALCLAW_API_KEY=your_workspace_api_key
|
|
61
|
+
```
|
|
62
|
+
|
|
63
|
+
Get your API key at [getsocialclaw.com](https://getsocialclaw.com).
|
|
64
|
+
|
|
65
|
+
## Workflow
|
|
66
|
+
|
|
67
|
+
### Step 1: Create a Campaign
|
|
68
|
+
|
|
69
|
+
Define your campaign with target platforms, content, and schedule.
|
|
70
|
+
|
|
71
|
+
### Step 2: Upload Media (Optional)
|
|
72
|
+
|
|
73
|
+
Upload images or videos to attach to posts.
|
|
74
|
+
|
|
75
|
+
### Step 3: Validate Schedule
|
|
76
|
+
|
|
77
|
+
Confirm platform-specific timing rules are met (e.g., rate limits, posting windows).
|
|
78
|
+
|
|
79
|
+
### Step 4: Publish or Schedule
|
|
80
|
+
|
|
81
|
+
Publish immediately or schedule for a future time across all selected platforms simultaneously.
|
|
82
|
+
|
|
83
|
+
### Step 5: Analytics
|
|
84
|
+
|
|
85
|
+
Retrieve post performance metrics after publishing.
|
|
86
|
+
|
|
87
|
+
## Example Usage
|
|
88
|
+
|
|
89
|
+
```
|
|
90
|
+
/social-publishing
|
|
91
|
+
|
|
92
|
+
Create a campaign for our product launch:
|
|
93
|
+
- Platforms: X, LinkedIn, Instagram
|
|
94
|
+
- Message: "Excited to announce our new feature! Check it out at example.com #launch #product"
|
|
95
|
+
- Schedule: Tomorrow at 9am PST
|
|
96
|
+
```
|
|
97
|
+
|
|
98
|
+
## Source
|
|
99
|
+
|
|
100
|
+
GitHub: [ndesv21/socialclaw](https://github.com/ndesv21/socialclaw)
|
|
101
|
+
Website: [getsocialclaw.com](https://getsocialclaw.com)
|
|
102
|
+
|
|
103
|
+
## Limitations
|
|
104
|
+
|
|
105
|
+
- Requires a valid SocialClaw workspace API key; do not attempt publishing without explicit user-provided credentials.
|
|
106
|
+
- Platform availability, rate limits, analytics fields, and scheduling behavior depend on the upstream SocialClaw service.
|
|
107
|
+
- This skill describes the publishing workflow; it does not replace platform-specific compliance, brand review, or legal approval before posting.
|
package/package.json
CHANGED
package/skills_index.json
CHANGED
|
@@ -12725,6 +12725,28 @@
|
|
|
12725
12725
|
"reasons": []
|
|
12726
12726
|
}
|
|
12727
12727
|
},
|
|
12728
|
+
{
|
|
12729
|
+
"id": "flowhunt-skill",
|
|
12730
|
+
"path": "skills/flowhunt-skill",
|
|
12731
|
+
"category": "automation",
|
|
12732
|
+
"name": "flowhunt-skill",
|
|
12733
|
+
"description": "Automation discovery audit skill. Walks through a 5-question workflow intake, then audits Gmail/Calendar/Slack/task trackers to identify automation opportunities. Use when a user wants to discover what processes in their business can be automated.",
|
|
12734
|
+
"risk": "safe",
|
|
12735
|
+
"source": "community",
|
|
12736
|
+
"date_added": "2026-05-23",
|
|
12737
|
+
"plugin": {
|
|
12738
|
+
"targets": {
|
|
12739
|
+
"codex": "supported",
|
|
12740
|
+
"claude": "supported"
|
|
12741
|
+
},
|
|
12742
|
+
"setup": {
|
|
12743
|
+
"type": "none",
|
|
12744
|
+
"summary": "",
|
|
12745
|
+
"docs": null
|
|
12746
|
+
},
|
|
12747
|
+
"reasons": []
|
|
12748
|
+
}
|
|
12749
|
+
},
|
|
12728
12750
|
{
|
|
12729
12751
|
"id": "flutter-expert",
|
|
12730
12752
|
"path": "skills/flutter-expert",
|
|
@@ -13693,6 +13715,28 @@
|
|
|
13693
13715
|
"reasons": []
|
|
13694
13716
|
}
|
|
13695
13717
|
},
|
|
13718
|
+
{
|
|
13719
|
+
"id": "geminiignore-finops",
|
|
13720
|
+
"path": "skills/geminiignore-finops",
|
|
13721
|
+
"category": "context-optimization",
|
|
13722
|
+
"name": "geminiignore-finops",
|
|
13723
|
+
"description": "Configure and optimize .geminiignore files for AI context window efficiency and token cost reduction (FinOps).",
|
|
13724
|
+
"risk": "safe",
|
|
13725
|
+
"source": "community",
|
|
13726
|
+
"date_added": "2026-05-25",
|
|
13727
|
+
"plugin": {
|
|
13728
|
+
"targets": {
|
|
13729
|
+
"codex": "supported",
|
|
13730
|
+
"claude": "supported"
|
|
13731
|
+
},
|
|
13732
|
+
"setup": {
|
|
13733
|
+
"type": "none",
|
|
13734
|
+
"summary": "",
|
|
13735
|
+
"docs": null
|
|
13736
|
+
},
|
|
13737
|
+
"reasons": []
|
|
13738
|
+
}
|
|
13739
|
+
},
|
|
13696
13740
|
{
|
|
13697
13741
|
"id": "geo-fundamentals",
|
|
13698
13742
|
"path": "skills/geo-fundamentals",
|
|
@@ -15741,6 +15785,28 @@
|
|
|
15741
15785
|
"reasons": []
|
|
15742
15786
|
}
|
|
15743
15787
|
},
|
|
15788
|
+
{
|
|
15789
|
+
"id": "ii-commons",
|
|
15790
|
+
"path": "skills/ii-commons",
|
|
15791
|
+
"category": "research",
|
|
15792
|
+
"name": "ii-commons",
|
|
15793
|
+
"description": "Deterministic search across arXiv, PubMed/PMC, and US policy corpora with daily freshness cutoffs.",
|
|
15794
|
+
"risk": "safe",
|
|
15795
|
+
"source": "community",
|
|
15796
|
+
"date_added": "2026-05-26",
|
|
15797
|
+
"plugin": {
|
|
15798
|
+
"targets": {
|
|
15799
|
+
"codex": "supported",
|
|
15800
|
+
"claude": "supported"
|
|
15801
|
+
},
|
|
15802
|
+
"setup": {
|
|
15803
|
+
"type": "none",
|
|
15804
|
+
"summary": "",
|
|
15805
|
+
"docs": null
|
|
15806
|
+
},
|
|
15807
|
+
"reasons": []
|
|
15808
|
+
}
|
|
15809
|
+
},
|
|
15744
15810
|
{
|
|
15745
15811
|
"id": "ilya-sutskever",
|
|
15746
15812
|
"path": "skills/ilya-sutskever",
|
|
@@ -18897,6 +18963,28 @@
|
|
|
18897
18963
|
"reasons": []
|
|
18898
18964
|
}
|
|
18899
18965
|
},
|
|
18966
|
+
{
|
|
18967
|
+
"id": "mesh-memory",
|
|
18968
|
+
"path": "skills/mesh-memory",
|
|
18969
|
+
"category": "ai-ml",
|
|
18970
|
+
"name": "mesh-memory",
|
|
18971
|
+
"description": "Self-hosted semantic memory for AI agents via MCP. Save worklogs, decisions, and notes, then recall them across sessions by meaning, not keyword. Postgres + pgvector with auto-tagging.",
|
|
18972
|
+
"risk": "safe",
|
|
18973
|
+
"source": "dklymentiev/mesh-memory (MIT)",
|
|
18974
|
+
"date_added": "2026-05-23",
|
|
18975
|
+
"plugin": {
|
|
18976
|
+
"targets": {
|
|
18977
|
+
"codex": "supported",
|
|
18978
|
+
"claude": "supported"
|
|
18979
|
+
},
|
|
18980
|
+
"setup": {
|
|
18981
|
+
"type": "none",
|
|
18982
|
+
"summary": "",
|
|
18983
|
+
"docs": null
|
|
18984
|
+
},
|
|
18985
|
+
"reasons": []
|
|
18986
|
+
}
|
|
18987
|
+
},
|
|
18900
18988
|
{
|
|
18901
18989
|
"id": "metasploit-framework",
|
|
18902
18990
|
"path": "skills/metasploit-framework",
|
|
@@ -27148,6 +27236,28 @@
|
|
|
27148
27236
|
"reasons": []
|
|
27149
27237
|
}
|
|
27150
27238
|
},
|
|
27239
|
+
{
|
|
27240
|
+
"id": "socialclaw",
|
|
27241
|
+
"path": "skills/socialclaw",
|
|
27242
|
+
"category": "marketing",
|
|
27243
|
+
"name": "socialclaw",
|
|
27244
|
+
"description": "Agent-first social media publishing skill \u2014 schedule and publish posts across 13 platforms (X, LinkedIn, Instagram, Facebook Pages, TikTok, Discord, Telegram, YouTube, Reddit, WordPress, Pinterest) via a single workspace API key.",
|
|
27245
|
+
"risk": "safe",
|
|
27246
|
+
"source": "community",
|
|
27247
|
+
"date_added": "2026-05-25",
|
|
27248
|
+
"plugin": {
|
|
27249
|
+
"targets": {
|
|
27250
|
+
"codex": "supported",
|
|
27251
|
+
"claude": "supported"
|
|
27252
|
+
},
|
|
27253
|
+
"setup": {
|
|
27254
|
+
"type": "none",
|
|
27255
|
+
"summary": "",
|
|
27256
|
+
"docs": null
|
|
27257
|
+
},
|
|
27258
|
+
"reasons": []
|
|
27259
|
+
}
|
|
27260
|
+
},
|
|
27151
27261
|
{
|
|
27152
27262
|
"id": "software-architecture",
|
|
27153
27263
|
"path": "skills/software-architecture",
|