opencode-skills-collection 3.0.27 → 3.0.29
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 +16 -1
- package/bundled-skills/bumblebee/SKILL.md +186 -0
- package/bundled-skills/bumblebee/scripts/render_report.py +362 -0
- package/bundled-skills/complexity-cuts/SKILL.md +254 -0
- package/bundled-skills/decision-navigator/SKILL.md +238 -0
- 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/invariant-guard/SKILL.md +307 -0
- package/bundled-skills/lemmaly/SKILL.md +236 -0
- package/bundled-skills/mathguard/SKILL.md +269 -0
- package/bundled-skills/mesh-memory/SKILL.md +161 -0
- package/bundled-skills/sendblue/sendblue-api/SKILL.md +194 -0
- package/bundled-skills/sendblue/sendblue-cli/SKILL.md +145 -0
- package/bundled-skills/sendblue/sendblue-notify/SKILL.md +173 -0
- package/bundled-skills/sendblue/textme/SKILL.md +232 -0
- package/bundled-skills/socialclaw/SKILL.md +107 -0
- package/package.json +1 -1
- package/skills_index.json +330 -0
|
@@ -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,480+ 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,480+ 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,480+ 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,480+ 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.
|