margins

Automates Markdown review workflows by pushing files and posting discussions via Margins.

Updated Mar 28, 2026
One-click install
npx skills add https://github.com/alvistar/margins-cli --skill margins
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: margins
Source: https://github.com/alvistar/margins-cli/tree/main/margins-plugin/skills/margins
Command: npx skills add https://github.com/alvistar/margins-cli --skill margins

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Upload and manage Markdown review workflows against Margins: push local MD files for human review and post discussions anchored to specific files.

Core Features & Use Cases

  • Push workflow: upload local Markdown files to Margins for review, create or overlay workspaces as needed, and print the review URL.
  • Discuss workflow: post discussions anchored to a file, automatically create the workspace if it doesn't exist, and support per-repo workspace identity.
  • GitHub/GitLab integration: automatically overlay local changes on top of a GitHub/GitLab workspace or operate entirely locally, with a reference path to open reviews.

Quick Start

Run /margins push to upload your project for review, or /margins discuss to start a discussion anchored to a file.

Frequently Asked Questions about margins

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I push Markdown files for human review from the CLI?▼

To push Markdown files for review, use the margins push workflow to upload local files to the Margins platform, automatically creating or overlaying workspaces and printing the review URL.

Can I post discussions anchored to a specific Markdown file?▼

Yes, you can post discussions anchored to a file using the margins discuss workflow, which automatically creates the workspace if it does not exist and supports per-repo workspace identity.

Does the margins CLI work with GitHub and GitLab repositories?▼

Yes, the margins CLI supports GitHub and GitLab integration by automatically overlaying local changes on top of a GitHub or GitLab workspace, or operating entirely locally with a reference path.

What happens if authentication fails or payload limits are exceeded?▼

Authentication failures, payload limits, and invalid paths are handled automatically by the margins CLI to keep Markdown review workflows smooth and prevent common errors from interrupting the process.

Do I need to manually create a workspace before uploading Markdown files?▼

No, you do not need to manually create a workspace before uploading Markdown files; the margins CLI automatically creates or overlays workspaces as needed and persists workspace identity.