Alephant FinOps Skill

alephant-skill is the canonical skill repository. This folder is what you publish to the repo / GitHub. The only skill file is skills/alephant-finops/SKILL.md — edit that file directly. add-skill installs from the same path at repo root.

Agent skill for Alephant FinOps: budget status, cost/spend, virtual keys, policy (block/low-cost/restore), and cost audit reports. The skill instructs the agent to use Alephant MCP tools and prompts and to suggest Alephant Cockpit for charts or multi-key views.

Prerequisite: Alephant MCP Server must be configured in your agent (e.g. in Cursor: npx -y @gengbingbing/alephant-mcp). Set ALEPHANT_TOKEN or ALEPHANT_VIRTUAL_KEY (and optionally ALEPHANT_API_BASE_URL) as needed.

Install

Three ways to install (no clone needed for the first and third):

1. npx (recommended) — Project: npx @gengbingbing/alephant-skill. User-wide: npx @gengbingbing/alephant-skill --global or -g. Multiple agents: npx @gengbingbing/alephant-skill -g -a cursor -a codex.
2. npx skills add — From GitHub: npx skills add <owner/repo> --skill alephant-finops. From this monorepo: npx skills add AlephantAI/AlephantAI-20260305 --skill alephant-finops. Add -g, -a cursor etc. as needed.
3. Cursor /plugin install — In Cursor chat or command palette: /plugin install @gengbingbing/alephant-skill.

Option 1: npx or local installer

Without cloning (after the package is published):

npx @gengbingbing/alephant-skill
npx @gengbingbing/alephant-skill --global
npx @gengbingbing/alephant-skill -g -a cursor -a codex

From a local clone (e.g. this folder or parent repo):

node install.mjs
# or from parent root: node alephant-skill/install.mjs

• Default: Cursor only, project scope: .cursor/skills/alephant-finops/
• Global: -g → ~/.cursor/skills/alephant-finops/
• Agents: -a cursor | codex | claude-code | opencode (repeat for multiple)

Option 2: npx skills add (from GitHub)

Using the add-skill / skills CLI:

npx skills add AlephantAI/AlephantAI-20260305 --skill alephant-finops

Use -g for global, -a cursor (or other agent) to target a specific agent.

Option 3: Cursor /plugin install

In Cursor, run:

/plugin install @gengbingbing/alephant-skill

Single source of truth

The canonical skill file is alephant-skill/skills/alephant-finops/SKILL.md. If you only edit that file, run from the repo root before publishing or for npx skills add to see the latest:

node alephant-skill/sync-to-skills.mjs

This updates skills/alephant-finops/SKILL.md at the repo root.

Install target

The skill is installed under the directory alephant-finops (matching the skill name in SKILL.md frontmatter), so it appears as one skill in your agent’s skills list.