@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.
@@ -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
+ }