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.