{"_id":"@algovaultlabs/skills","name":"@algovaultlabs/skills","dist-tags":{"latest":"0.2.0"},"versions":{"0.2.0":{"name":"@algovaultlabs/skills","version":"0.2.0","private":false,"type":"module","description":"20 Agent Skills over AlgoVault MCP","homepage":"https://algovault.com","repository":{"type":"git","url":"git+https://github.com/AlgoVaultLabs/algovault-skills.git"},"license":"MIT","author":{"name":"AlgoVault Labs"},"scripts":{"preflight":"bash scripts/skills_preflight.sh","gen":"node scripts/gen-skill.mjs","gen:dry":"node scripts/gen-skill.mjs --dry-run","test":"node --test tests/smoke/*.mjs","test:unit":"node --test tests/unit/*.mjs"},"engines":{"node":">=20"},"dependencies":{"@modelcontextprotocol/sdk":"^1.12.1","zod":"^3.22.4"},"gitHead":"d84cbff853df6d16d0729a8b2615b1c467a86908","_id":"@algovaultlabs/skills@0.2.0","bugs":{"url":"https://github.com/AlgoVaultLabs/algovault-skills/issues"},"_nodeVersion":"25.9.0","_npmVersion":"11.12.1","dist":{"integrity":"sha512-esWe5PzswCJjnvqyZ/Vip0bc7/bJN9ehOnEA6Urv0a11jTjWxAqzjmLsyOW94oR+VfkVxwikMHCvDWitv3e8SA==","shasum":"36dac93e1a2b8f659f2945b2964e021c5707830c","tarball":"https://registry.npmjs.org/@algovaultlabs/skills/-/skills-0.2.0.tgz","fileCount":94,"unpackedSize":389129,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQCmNBKKjkw0TZ7TEbHUtcT4RWKSpKYO0SUuYm0GN2o/dwIhALSvR1/wVhA+oYVTqzhwDhx+m4ufS9VywJ+icSLpQ4zh"}]},"_npmUser":{"name":"algovaultdev","email":"admin@algovault.com"},"directories":{},"maintainers":[{"name":"algovaultdev","email":"admin@algovault.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/skills_0.2.0_1779085030842_0.8657242650545656"},"_hasShrinkwrap":false}},"time":{"created":"2026-05-18T06:17:10.730Z","0.2.0":"2026-05-18T06:17:11.010Z","modified":"2026-05-18T06:17:11.314Z"},"maintainers":[{"name":"algovaultdev","email":"admin@algovault.com"}],"description":"20 Agent Skills over AlgoVault MCP","homepage":"https://algovault.com","repository":{"type":"git","url":"git+https://github.com/AlgoVaultLabs/algovault-skills.git"},"author":{"name":"AlgoVault Labs"},"bugs":{"url":"https://github.com/AlgoVaultLabs/algovault-skills/issues"},"license":"MIT","readme":"# AlgoVault Skills\n\n**20 Anthropic Agent Skills over the [AlgoVault MCP server](https://api.algovault.com/mcp).**\n\nEach Skill is a single-prompt wrapper over 1–3 calls to AlgoVault's signal-interpretation API\n(`get_market_regime`, `get_trade_signal`, `scan_funding_arb`). Install once, invoke from any\nClaude Code or Cowork session, and we surface the composite verdict — your agent decides execution.\n\n> AlgoVault provides the thesis; your agent decides execution.\n\n## Quick start\n\n```bash\n# In Claude Code\nclaude plugin install AlgoVaultLabs/algovault-skills\n\n# In Cowork — discover via the marketplace, click \"install\"\n```\n\nLive track record (PFE Win Rate + cumulative call count, updated continuously):\n**https://algovault.com/track-record**\n\n## Integrations\n\nEnd-to-end tutorials pairing AlgoVault's analytics with each major exchange's\nagent execution kit. AlgoVault returns the verdict; the agent and its risk\npolicy decide what (if anything) to execute. **All demos run on testnet/demo\nmode — zero real-money risk.**\n\n<!-- BUILD:README_INTEGRATIONS_TABLE -->\n| # | Exchange | Tutorial | Demo | Mirror |\n|---|---|---|---|---|\n| 01 | Binance | [`docs/integrations/binance.md`](docs/integrations/binance.md) | [`examples/binance/demo.mjs`](examples/binance/demo.mjs) | [algovault.com/docs/integrations/binance](https://algovault.com/docs/integrations/binance) |\n| 02 | OKX | [`docs/integrations/okx.md`](docs/integrations/okx.md) | [`examples/okx/demo.mjs`](examples/okx/demo.mjs) | [algovault.com/docs/integrations/okx](https://algovault.com/docs/integrations/okx) |\n| 03 | Bybit | [`docs/integrations/bybit.md`](docs/integrations/bybit.md) | [`examples/bybit/demo.mjs`](examples/bybit/demo.mjs) | [algovault.com/docs/integrations/bybit](https://algovault.com/docs/integrations/bybit) |\n| 04 | Bitget | [`docs/integrations/bitget.md`](docs/integrations/bitget.md) | [`examples/bitget/demo.mjs`](examples/bitget/demo.mjs) | [algovault.com/docs/integrations/bitget](https://algovault.com/docs/integrations/bitget) |\n<!-- /BUILD:README_INTEGRATIONS_TABLE -->\n\nQuick install + run any demo:\n\n```bash\nclaude plugin install AlgoVaultLabs/algovault-skills\ngit clone https://github.com/AlgoVaultLabs/algovault-skills && cd algovault-skills && npm install\nBINANCE_TESTNET=true node examples/binance/demo.mjs   # or OKX_DEMO=true / BYBIT_TESTNET=true / BITGET_DEMO=true\n```\n\n### Framework integrations\n\nDrop-in tutorials for the major Python agent frameworks. Each tutorial pairs\nAlgoVault MCP with the framework's canonical MCP-adapter library — copy-pasteable\ndemo code, no AlgoVault SDK required. `python examples/<framework>/demo.py BTC 4h`\nreturns a real BUY/SELL/HOLD verdict from `api.algovault.com/mcp`.\n\n<!-- BUILD:README_FRAMEWORK_INTEGRATIONS_TABLE -->\n| # | Framework | Tutorial | Demo | Mirror |\n|---|---|---|---|---|\n| 01 | LangChain | [`docs/integrations/langchain.md`](docs/integrations/langchain.md) | [`examples/langchain/demo.py`](examples/langchain/demo.py) | [algovault.com/docs/integrations/langchain](https://algovault.com/docs/integrations/langchain) |\n| 02 | LlamaIndex | [`docs/integrations/llamaindex.md`](docs/integrations/llamaindex.md) | [`examples/llamaindex/demo.py`](examples/llamaindex/demo.py) | [algovault.com/docs/integrations/llamaindex](https://algovault.com/docs/integrations/llamaindex) |\n| 03 | Microsoft Agent Framework | [`docs/integrations/maf.md`](docs/integrations/maf.md) | [`examples/maf/demo.py`](examples/maf/demo.py) | [algovault.com/docs/integrations/maf](https://algovault.com/docs/integrations/maf) |\n| 04 | CrewAI | [`docs/integrations/crewai.md`](docs/integrations/crewai.md) | [`examples/crewai/demo.py`](examples/crewai/demo.py) | [algovault.com/docs/integrations/crewai](https://algovault.com/docs/integrations/crewai) |\n<!-- /BUILD:README_FRAMEWORK_INTEGRATIONS_TABLE -->\n\n## The 20 Skills\n\n<!-- SKILLS_TABLE -->\n<!-- BUILD:README_SKILLS_TABLE -->\n| # | Slug | Name | Difficulty | Tools |\n|---|---|---|---|---|\n| 01 | [`quick-btc-check`](skills/quick-btc-check/SKILL.md) | Quick BTC Check | Beginner | `get_trade_signal` |\n| 02 | [`portfolio-scanner`](skills/portfolio-scanner/SKILL.md) | Portfolio Scanner | Intermediate | `get_trade_signal` |\n| 03 | [`regime-aware-trading`](skills/regime-aware-trading/SKILL.md) | Regime-Aware Trading | Intermediate | `get_market_regime`, `get_trade_signal` |\n| 04 | [`funding-arb-monitor`](skills/funding-arb-monitor/SKILL.md) | Funding Arb Monitor | Intermediate | `scan_funding_arb` |\n| 05 | [`full-3-tool-pipeline`](skills/full-3-tool-pipeline/SKILL.md) | Full 3-Tool Pipeline | Advanced | `get_market_regime`, `get_trade_signal`, `scan_funding_arb` |\n| 06 | [`multi-timeframe-confirmation`](skills/multi-timeframe-confirmation/SKILL.md) | Multi-Timeframe Confirmation | Advanced | `get_trade_signal` |\n| 07 | [`tradfi-rotation`](skills/tradfi-rotation/SKILL.md) | TradFi Rotation | Advanced | `get_market_regime`, `get_trade_signal` |\n| 08 | [`risk-gated-entry`](skills/risk-gated-entry/SKILL.md) | Risk-Gated Entry | Advanced | `get_market_regime`, `get_trade_signal` |\n| 09 | [`funding-sentiment-dashboard`](skills/funding-sentiment-dashboard/SKILL.md) | Funding Sentiment Dashboard | Advanced | `get_market_regime` |\n| 10 | [`contrarian-meme-scanner`](skills/contrarian-meme-scanner/SKILL.md) | Contrarian Meme Scanner | Advanced | `get_market_regime`, `get_trade_signal` |\n| 11 | [`divergence-detector`](skills/divergence-detector/SKILL.md) | Divergence Detector | Advanced | `get_market_regime`, `get_trade_signal` |\n| 12 | [`hourly-digest-bot`](skills/hourly-digest-bot/SKILL.md) | Hourly Digest Bot | Advanced | `get_trade_signal`, `get_market_regime` |\n| 13 | [`hedging-advisor`](skills/hedging-advisor/SKILL.md) | Hedging Advisor | Advanced | `get_market_regime`, `get_trade_signal`, `scan_funding_arb` |\n| 14 | [`volatility-breakout-watch`](skills/volatility-breakout-watch/SKILL.md) | Volatility Breakout Watch | Advanced | `get_market_regime`, `get_trade_signal` |\n| 15 | [`cross-asset-correlation`](skills/cross-asset-correlation/SKILL.md) | Cross-Asset Correlation | Advanced | `get_trade_signal` |\n| 16 | [`funding-cash-and-carry`](skills/funding-cash-and-carry/SKILL.md) | Funding Cash-and-Carry | Advanced | `scan_funding_arb`, `get_trade_signal` |\n| 17 | [`weekend-vs-weekday-patterns`](skills/weekend-vs-weekday-patterns/SKILL.md) | Weekend vs Weekday Patterns | Research | `get_trade_signal`, `get_market_regime` |\n| 18 | [`agent-portfolio-rebalance`](skills/agent-portfolio-rebalance/SKILL.md) | Agent Portfolio Rebalance | Advanced | `get_market_regime` |\n| 19 | [`smart-dca-bot`](skills/smart-dca-bot/SKILL.md) | Smart DCA Bot | Advanced | `get_trade_signal` |\n| 20 | [`multi-agent-war-room`](skills/multi-agent-war-room/SKILL.md) | Multi-Agent War Room | Expert | `get_market_regime`, `get_trade_signal`, `scan_funding_arb` |\n<!-- /BUILD:README_SKILLS_TABLE -->\n<!-- /SKILLS_TABLE -->\n\n## How attribution works\n\nEvery Skill invocation sends `X-AlgoVault-Skill-Slug: <slug>` to the MCP server. We aggregate\nthese in an admin-only counter inside `/dashboard` on `api.algovault.com` (per-Skill funnel\ndata is competitive intel — moved internal 2026-04-24). The public moat layer remains the\naggregate track record at <https://algovault.com/track-record> (Merkle-verified PFE WR +\nsignal/batch counts).\n\n## Repo layout\n\n```\nalgovault-skills/\n├── .claude-plugin/\n│   ├── plugin.json           # Plugin manifest (mcpServers, version, etc.)\n│   └── marketplace.json      # Marketplace entry\n├── skills/\n│   ├── _template/            # SKILL.md.tmpl — generator template\n│   ├── manifest.json         # Single source of truth: 20 Skill definitions\n│   ├── manifest.schema.json  # JSON Schema v7 for manifest validation\n│   └── <slug>/SKILL.md       # GENERATED — never hand-edit\n├── scripts/\n│   ├── gen-skill.mjs         # Reads manifest, emits SKILL.md per entry\n│   └── skills_preflight.sh   # Pre-build environment check\n├── tests/smoke/              # Live invocation tests against api.algovault.com\n└── docs/                     # HOW_TO_ADD.md + integrations/{binance,okx,bybit,bitget}.md + SUBMIT_<EXCHANGE>.md templates\n```\n\n## Development\n\n```bash\nnpm run preflight             # Verify env + repo + MCP reachable\nnpm run gen                   # Regenerate all SKILL.md files from manifest\nnpm test                      # Live smoke test against api.algovault.com\nnpm run test:unit             # Offline unit tests (helper + template-consistency canary)\n```\n\n### Submission generator\n\n`scripts/generate_skill_submission.mjs` reads a `docs/SUBMIT_<EXCHANGE>.md`\ntemplate, fetches live track-record data from the AlgoVault API, and emits\nready-to-paste submission artifacts (`SKILL.md` for Skills-Hub PRs,\n`PR_TITLE.txt`, `PR_BODY.md`, `SUMMARY.md` for every exchange):\n\n```bash\nnode scripts/generate_skill_submission.mjs --exchange BINANCE\nnode scripts/generate_skill_submission.mjs --exchange BYBIT --output-dir /tmp/foo/\n```\n\nTemplates use `<PLACEHOLDER>` tokens (`<PFE_WR>`, `<TOTAL_CALLS>`,\n`<BATCH_COUNT>`, `<VERSION>`, etc.) so submission text never carries stale\nhardcoded numbers. CI canary `tests/unit/submit-template-consistency.test.mjs`\nfails the build if any template re-introduces a literal — keeps the templating\ndiscipline locked in.\n\n## Contributing\n\nSkills are added via `skills/manifest.json` only — never hand-edit generated `SKILL.md` files.\nAdd a manifest entry, run `npm run gen`, commit both. PRs welcome.\n\n## Also built by AlgoVault Labs\n\n- **`@algovaultofficialbot`** — free public Telegram bot. Regime alerts + AlgoVault trade calls (BUY/SELL) pushed to your watchlist. Same composite-verdict signal stream these skills wrap. Source: [github.com/AlgoVaultLabs/algovault-bot](https://github.com/AlgoVaultLabs/algovault-bot).\n\n## Built by [AlgoVault Labs](https://algovault.com)\n\nComposable signal-interpretation tools for AI trading agents — MIT licensed.\n","readmeFilename":"README.md","_rev":"1-780a4f05f0ddf4791252e09bac24ee74"}