@woopsy/ai-agent-skills 1.0.0
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/.claude-plugin/marketplace.json +14 -0
- package/.claude-plugin/plugin.json +23 -0
- package/README.md +60 -0
- package/SKILL.md +87 -0
- package/bin/ai-agent-skills.js +59 -0
- package/install.ps1 +463 -0
- package/install.sh +224 -0
- package/package.json +41 -0
- package/scripts/install.js +51 -0
- package/scripts/push.js +193 -0
- package/skills/cicd/SKILL.md +134 -0
- package/skills/secondary-brain/SKILL.md +257 -0
- package/skills/secondary-brain/reference/deep-mode.md +90 -0
- package/skills/secondary-brain/reference/mermaid-cheatsheet.md +81 -0
- package/skills/secondary-brain/reference/platform-adapters.md +74 -0
- package/skills/secondary-brain/reference/scoring-guide.md +63 -0
- package/skills/secondary-brain/templates/00-project-node.md +41 -0
- package/skills/secondary-brain/templates/01-feature-node.md +39 -0
- package/skills/secondary-brain/templates/handoff.md +47 -0
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
{
|
|
2
|
+
"name": "ai-agent-skills",
|
|
3
|
+
"owner": {
|
|
4
|
+
"name": "ai-agent-skills"
|
|
5
|
+
},
|
|
6
|
+
"plugins": [
|
|
7
|
+
{
|
|
8
|
+
"name": "ai-agent-skills",
|
|
9
|
+
"source": "./",
|
|
10
|
+
"description": "Multi-function AI agent skills — SecondaryBrain vault protocol, CI/CD pipeline, auto-installer",
|
|
11
|
+
"version": "1.0.0"
|
|
12
|
+
}
|
|
13
|
+
]
|
|
14
|
+
}
|
|
@@ -0,0 +1,23 @@
|
|
|
1
|
+
{
|
|
2
|
+
"name": "ai-agent-skills",
|
|
3
|
+
"version": "1.0.0",
|
|
4
|
+
"description": "Multi-function AI agent skills — SecondaryBrain vault protocol, CI/CD pipeline, auto-installer for Claude Code, opencode, Cursor, Codex, Gemini, Antigravity, Copilot, GPT",
|
|
5
|
+
"author": {
|
|
6
|
+
"name": "ai-agent-skills"
|
|
7
|
+
},
|
|
8
|
+
"repository": "https://github.com/ai-agent-skills/WoopsySkill",
|
|
9
|
+
"license": "MIT",
|
|
10
|
+
"keywords": [
|
|
11
|
+
"secondary-brain",
|
|
12
|
+
"obsidian",
|
|
13
|
+
"vault",
|
|
14
|
+
"cicd",
|
|
15
|
+
"agents",
|
|
16
|
+
"skills",
|
|
17
|
+
"claude-code",
|
|
18
|
+
"opencode",
|
|
19
|
+
"cursor",
|
|
20
|
+
"codex",
|
|
21
|
+
"gemini"
|
|
22
|
+
]
|
|
23
|
+
}
|
package/README.md
ADDED
|
@@ -0,0 +1,60 @@
|
|
|
1
|
+
# AI Agent Skills
|
|
2
|
+
|
|
3
|
+
Multi-function skill repository for AI coding agents. Includes:
|
|
4
|
+
|
|
5
|
+
- **secondary-brain** — Persistent project memory via Obsidian vault
|
|
6
|
+
- **obsidian** — Obsidian tooling (markdown, bases, canvas, CLI)
|
|
7
|
+
- **cicd** — CI/CD pipeline automation
|
|
8
|
+
|
|
9
|
+
## Quick Install
|
|
10
|
+
|
|
11
|
+
### Windows (PowerShell)
|
|
12
|
+
|
|
13
|
+
```powershell
|
|
14
|
+
.\install.ps1
|
|
15
|
+
```
|
|
16
|
+
|
|
17
|
+
### WSL / Linux
|
|
18
|
+
|
|
19
|
+
```bash
|
|
20
|
+
chmod +x install.sh
|
|
21
|
+
./install.sh
|
|
22
|
+
```
|
|
23
|
+
|
|
24
|
+
The installer auto-detects your Obsidian vault and installed AI agents (Claude Code, opencode, Cursor, Codex, Gemini, Copilot, Antigravity).
|
|
25
|
+
|
|
26
|
+
## Usage
|
|
27
|
+
|
|
28
|
+
Once installed, invoke skills from your AI agent:
|
|
29
|
+
|
|
30
|
+
- `use secondary-brain:connect` — read vault before task, update after
|
|
31
|
+
- `use secondary-brain:deep` — full ceremony (scoring, pruning, prediction)
|
|
32
|
+
- `use secondary-brain:handoff` — generate project handoff for another agent
|
|
33
|
+
- `use secondary-brain:status` — check vault health
|
|
34
|
+
- `use cicd:push` — learn the npm run push flow
|
|
35
|
+
|
|
36
|
+
## npm Scripts
|
|
37
|
+
|
|
38
|
+
| Script | Description |
|
|
39
|
+
|---|---|
|
|
40
|
+
| `npm run push` | Interactive git push with CI quality gates |
|
|
41
|
+
| `npm run install` | Run the installer |
|
|
42
|
+
|
|
43
|
+
## Project Structure
|
|
44
|
+
|
|
45
|
+
```
|
|
46
|
+
├── SKILL.md # Master skill — describes all sub-skills
|
|
47
|
+
├── skills/
|
|
48
|
+
│ ├── secondary-brain/ # Core: Obsidian vault integration
|
|
49
|
+
│ │ ├── SKILL.md # Canonical skill definition
|
|
50
|
+
│ │ ├── brain-config.json # Created by installer
|
|
51
|
+
│ │ ├── templates/ # Node templates for the vault
|
|
52
|
+
│ │ └── reference/ # Deep-mode docs, scoring, mermaid
|
|
53
|
+
│ ├── obsidian/ # Bundled from kepano/obsidian-skills
|
|
54
|
+
│ └── cicd/ # CI/CD pipeline instructions
|
|
55
|
+
├── scripts/
|
|
56
|
+
│ └── push.js # npm run push — git with quality gates
|
|
57
|
+
├── install.ps1 # Windows auto-installer
|
|
58
|
+
├── install.sh # WSL/Linux installer
|
|
59
|
+
└── .github/workflows/ # CI/CD pipeline definitions
|
|
60
|
+
```
|
package/SKILL.md
ADDED
|
@@ -0,0 +1,87 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: ai-agent-skills
|
|
3
|
+
description: "Multi-function skill repository. Slash commands: /woopsy (full), /woopsy vault (vault only), /woopsy cdci (CI/CD pipeline + vault install + skill install)."
|
|
4
|
+
argument-hint: "[/woopsy|/woopsy vault|/woopsy cdci]"
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
# WoopsySkill — Master Controller
|
|
8
|
+
|
|
9
|
+
This skill dispatches to sub-skills based on the slash command used.
|
|
10
|
+
|
|
11
|
+
## Slash Commands
|
|
12
|
+
|
|
13
|
+
### `/woopsy` — Full Pipeline
|
|
14
|
+
|
|
15
|
+
Triggers EVERYTHING in sequence:
|
|
16
|
+
|
|
17
|
+
```
|
|
18
|
+
1. Update dependencies (obsidian-skills + graphify → git pull)
|
|
19
|
+
2. Connect vault (load context, detect project, report state)
|
|
20
|
+
3. Run CI/CD checks (branch check, remote check)
|
|
21
|
+
4. Offer push flow if changes exist
|
|
22
|
+
5. Document everything in changelog
|
|
23
|
+
```
|
|
24
|
+
|
|
25
|
+
Alias: `use ai-agent-skills:full`
|
|
26
|
+
|
|
27
|
+
### `/woopsy vault` — Vault Only
|
|
28
|
+
|
|
29
|
+
Triggers ONLY the vault feature:
|
|
30
|
+
|
|
31
|
+
```
|
|
32
|
+
1. Update dependencies (obsidian-skills + graphify → git pull)
|
|
33
|
+
2. Connect vault (load context, detect project, report state)
|
|
34
|
+
3. Document changes in changelog
|
|
35
|
+
4. Update project nodes
|
|
36
|
+
```
|
|
37
|
+
|
|
38
|
+
No CI/CD, no push flow. Pure project memory management.
|
|
39
|
+
|
|
40
|
+
Alias: `use secondary-brain:connect`
|
|
41
|
+
|
|
42
|
+
### `/woopsy cdci` — CI/CD Pipeline
|
|
43
|
+
|
|
44
|
+
Triggers CI/CD pipeline including vault + skill installation:
|
|
45
|
+
|
|
46
|
+
```
|
|
47
|
+
1. Update dependencies (obsidian-skills + graphify → git pull)
|
|
48
|
+
2. Ensure vault is connected (install if missing)
|
|
49
|
+
3. Install all skills to current agent
|
|
50
|
+
4. Run CI checks (lint → typecheck → test)
|
|
51
|
+
5. Offer push flow with changelog gate
|
|
52
|
+
6. Block prod pushes
|
|
53
|
+
```
|
|
54
|
+
|
|
55
|
+
Alias: `use cicd:pipeline`
|
|
56
|
+
|
|
57
|
+
## Sub-Skills
|
|
58
|
+
|
|
59
|
+
| Skill | argument-hint | Purpose |
|
|
60
|
+
|---|---|---|
|
|
61
|
+
| `secondary-brain` | `[connect\|deep\|handoff\|status]` | Persistent project memory via Obsidian vault |
|
|
62
|
+
| `cicd` | `[pipeline\|setup\|push\|workflows]` | CI/CD pipeline with vault + skill install |
|
|
63
|
+
| `obsidian-markdown` | — | Obsidian Flavored Markdown syntax |
|
|
64
|
+
| `obsidian-bases` | — | Obsidian Bases (.base files) |
|
|
65
|
+
| `json-canvas` | — | JSON Canvas (.canvas files) |
|
|
66
|
+
| `obsidian-cli` | — | Obsidian CLI operations |
|
|
67
|
+
| `defuddle` | — | Web page to clean markdown |
|
|
68
|
+
|
|
69
|
+
## Usage
|
|
70
|
+
|
|
71
|
+
```
|
|
72
|
+
You: /woopsy
|
|
73
|
+
Agent: Runs full pipeline — vault context + CI/CD checks + push offer
|
|
74
|
+
|
|
75
|
+
You: /woopsy vault
|
|
76
|
+
Agent: Vault only — load context, document, update nodes
|
|
77
|
+
|
|
78
|
+
You: /woopsy cdci
|
|
79
|
+
Agent: CI/CD pipeline — ensure vault + skills installed, run gates, offer push
|
|
80
|
+
```
|
|
81
|
+
|
|
82
|
+
## Adding a New Skill
|
|
83
|
+
|
|
84
|
+
1. Create `skills/<name>/SKILL.md` with YAML frontmatter
|
|
85
|
+
2. Add any reference docs to `skills/<name>/reference/`
|
|
86
|
+
3. Update this master SKILL.md table and slash commands
|
|
87
|
+
4. Run the installer to propagate to your agents
|
|
@@ -0,0 +1,59 @@
|
|
|
1
|
+
#!/usr/bin/env node
|
|
2
|
+
|
|
3
|
+
const { execSync } = require('child_process');
|
|
4
|
+
const path = require('path');
|
|
5
|
+
const fs = require('fs');
|
|
6
|
+
|
|
7
|
+
const ROOT = path.resolve(__dirname, '..');
|
|
8
|
+
const args = process.argv.slice(2);
|
|
9
|
+
const cmd = args[0] || 'help';
|
|
10
|
+
|
|
11
|
+
function run(cmd) {
|
|
12
|
+
try { return execSync(cmd, { encoding: 'utf-8', cwd: ROOT }).trim(); }
|
|
13
|
+
catch { return ''; }
|
|
14
|
+
}
|
|
15
|
+
|
|
16
|
+
const COMMANDS = {
|
|
17
|
+
help() {
|
|
18
|
+
console.log(`
|
|
19
|
+
ai-agent-skills — Multi-function AI agent skill repository
|
|
20
|
+
|
|
21
|
+
USAGE
|
|
22
|
+
npx @woopsy/ai-agent-skills <command>
|
|
23
|
+
|
|
24
|
+
COMMANDS
|
|
25
|
+
install Install skills to all detected agents
|
|
26
|
+
vault Connect or scaffold an Obsidian vault
|
|
27
|
+
help Show this help
|
|
28
|
+
|
|
29
|
+
ALSO
|
|
30
|
+
npx skills add https://github.com/<your>/WoopsySkill
|
|
31
|
+
`);
|
|
32
|
+
},
|
|
33
|
+
|
|
34
|
+
install() {
|
|
35
|
+
console.log('Installing AI Agent Skills...\n');
|
|
36
|
+
require(path.join(ROOT, 'scripts', 'install.js'));
|
|
37
|
+
},
|
|
38
|
+
|
|
39
|
+
vault() {
|
|
40
|
+
const isWin = process.platform === 'win32';
|
|
41
|
+
const psScript = path.join(ROOT, 'install.ps1');
|
|
42
|
+
const shScript = path.join(ROOT, 'install.sh');
|
|
43
|
+
|
|
44
|
+
if (isWin && fs.existsSync(psScript)) {
|
|
45
|
+
run(`powershell.exe -ExecutionPolicy Bypass -File "${psScript}" -SkipAgentDetect`);
|
|
46
|
+
} else if (fs.existsSync(shScript)) {
|
|
47
|
+
run(`bash "${shScript}" --skip-agent-detect`);
|
|
48
|
+
} else {
|
|
49
|
+
console.log('No installer found for this platform.');
|
|
50
|
+
}
|
|
51
|
+
}
|
|
52
|
+
};
|
|
53
|
+
|
|
54
|
+
if (COMMANDS[cmd]) {
|
|
55
|
+
COMMANDS[cmd]();
|
|
56
|
+
} else {
|
|
57
|
+
console.log(`Unknown command: ${cmd}\n`);
|
|
58
|
+
COMMANDS.help();
|
|
59
|
+
}
|