Skill

margins-setup

Install the Margins CLI globally and configure authentication. Use when: "margins setup", "setup margins", "configure margins", or when /margins or /margins-read fails with "margins CLI not found".

npx claudepluginhub alvistar/margins-cli --plugin margins

Tool Access

This skill uses the workspace's default tool permissions.

Preview

```bash

SKILL.md

Similar Skills

cache-components

139.3k

Guides Next.js Cache Components and Partial Prerendering (PPR) with cacheComponents enabled. Implements 'use cache', cacheLife(), cacheTag(), revalidateTag(), static/dynamic optimization, and cache debugging.

cache-components

mcp-builder

124.2k

Guides building MCP servers enabling LLMs to interact with external services via tools. Covers best practices, TypeScript/Node (MCP SDK), Python (FastMCP).

9 files

anthropics-skills-13

canvas-design

124.2k

Generates original PNG/PDF visual art via design philosophy manifestos for posters, graphics, and static designs on user request.

20 files

anthropics-skills-13

Stats

Parent Repo Stars0

Parent Repo Forks0

Last CommitApr 8, 2026

Actions

View Source View Plugin View on GitHub View README

Help us improve

Share bugs, ideas, or general feedback.

/margins-setup — Install and Configure Margins CLI

Step 1: Check if margins CLI is already installed

command -v margins && margins --version

If the CLI is found, skip to Step 3 (credential check).

Step 2: Verify margins CLI is accessible via npx

The margins CLI is distributed via GitHub and invoked through npx. No global install needed.

npx --yes github:alvistar/margins-cli --version

If npx is not found, tell the user:

"Node.js is required. Install it from https://nodejs.org, then retry /margins-setup."

If the version check succeeds, the CLI is ready to use.

Step 3: Check for existing credentials

margins config show

If credentials exist (API key or OAuth tokens shown), skip to Step 5 (verification).

Step 4: Configure authentication

Ask the user via AskUserQuestion:

"How would you like to authenticate with Margins?"

Options:

OAuth login — Opens your browser for Keycloak SSO login (recommended for interactive use)
API key — Paste a static API key (recommended for CI/scripts)

If OAuth login

margins auth login

This opens a browser window for Keycloak authentication. The CLI starts a local HTTP server to receive the callback. Wait for the user to complete the browser flow.

If it fails with "invalid redirect_uri", the Keycloak client may not have localhost registered. Tell the user:

"Keycloak needs http://localhost:* registered as a redirect URI. Ask your admin to add it."

If API key

Ask: "Paste your Margins API key (starts with mrgn_):"

margins config set-key <key>

Step 5: Verify authentication

margins auth whoami

If successful, show the result and confirm:

"Margins CLI installed and authenticated. You can now use /margins and /margins-read."

If it fails, surface the error and suggest:

"Authentication verification failed. Try running margins auth login again."