{
  "markdown": "# Loops Agent Skills and Plugin\n\nOfficial installable Loops skills and plugin for AI coding agents.\n\nThis repository packages `SKILL.md`-based skills for working with Loops. It is intended to help agents use the Loops API, official SDKs, the Loops CLI, LMX email markup, and email-sending best practices more accurately.\n\nThese skills are designed for agent environments that support installable skills, such as Claude Code, Codex, Cursor, and other tools that work with the `skills` CLI.\n\n## Install skills\n\nFor `skills` CLI setup, agent-specific install targets, and the full list of flags, use the official docs:\n\n- https://skills.sh/docs/cli\n\nThis README only documents the Loops-specific install commands.\n\n```bash\n# See what this repo contains\nnpx skills add loops-so/skills --list\n\n# Install all Loops skills globally (recommended)\nnpx skills add loops-so/skills --global\n\n# Install specific Loops skills globally\nnpx skills add loops-so/skills --global --skill loops-api\nnpx skills add loops-so/skills --global --skill loops-cli\nnpx skills add loops-so/skills --global --skill loops-lmx\nnpx skills add loops-so/skills --global --skill loops-email-sending-best-practices\n```\n\nProject-level installs are also supported. Omit `--global` if you want the skills scoped to the current repository instead of user-level.\n\n### Pin a release\n\nThis repo is versioned with GitHub Releases. For stable installs, pin a release tag instead of installing from the default branch:\n\n```bash\nnpx skills add loops-so/skills#v1.0.0 --global\n```\n\n### Upgrading from unprefixed skill names\n\nOlder installs used the unprefixed skill names `api`, `cli`, `email-sending-best-practices`, and `lmx`. Installing the renamed `loops-*` skills does not automatically remove those old local skills. After installing the prefixed skills, remove the old names:\n\n```bash\nnpx skills remove api cli email-sending-best-practices lmx --global\n```\n\n## Install plugin\n\nThis repo can also be installed as a Plugin in certain agent environments.\n\n### ChatGPT / Codex\n\nInstall the plugin from the [ChatGPT Plugin directory](https://chatgpt.com/plugins/plugin_asdk_app_6a76060a3cbc81919eaaca7e37e830fe).\n\n### Claude\n\nInstall the plugin from the [Claude Plugin directory](https://claude.ai/directory/loops).\n\n### Cursor\n\nIn the Cursor desktop app:\n\n1. Go to Settings > Customize (or if in the Agents Window, click Customize in the left sidebar).\n1. Click **Browse Marketplace** and then the **All** option in the search bar. **Skills**.\n1. Select **Add Marketplace** and **Import from GitHub**. Paste in `https://github.com/loops-so/skills` and click **Import**.\n1. Once the Loops listing appears, click **Add**.\n\n## How to invoke skills\n\n| Platform        | Typical invocation                                                                                       |\n| --------------- | -------------------------------------------------------------------------------------------------------- |\n| **Claude Code** | `/loops-api`, `/loops-cli`, `/loops-lmx`, `/loops-email-sending-best-practices`  |\n| **Cursor**      | `/loops-api`, `/loops-cli`, `/loops-lmx`, `/loops-email-sending-best-practices` in Agent chat (type `/`) |\n| **Codex**       | Describe the task, or `@loops` / `@` and choose a skill                                                  |\n\n## Verify install\n\nAfter installation, try a task that should trigger one of the skills:\n\n- \"Add a contact to Loops from my Next.js backend.\"\n- \"Install the Loops CLI and authenticate against the right team.\"\n- \"Send a transactional email with the Loops CLI.\"\n- \"Design a new onboarding email using existing Loops themes/components, then write it in LMX.\"\n- \"Write an LMX onboarding email template.\"\n- \"Audit this onboarding email flow for deliverability issues.\"\n\n## What's included\n\nThis repo currently ships:\n\n- four installable skills that auto-load when relevant\n- detailed reference files for API, SDK, CLI, LMX, and email-program guidance\n\nThis repo does not currently ship:\n\n- slash commands\n- MCP servers\n\n## Available skills\n\n### `loops-api`\n\nUse this skill when you need to:\n\n- create, update, find, or delete contacts\n- create and manage custom contact properties\n- read mailing lists and update mailing-list membership\n- send Loops events from backend code\n- send transactional emails with the API or SDKs\n- create draft campaigns and update email-message content\n- create and update themes and reusable email components\n- create, update, and delete workflows and workflow nodes\n- receive and verify inbound Loops webhooks\n- upload images for use in email LMX content\n- choose between official SDKs and raw HTTP requests\n- handle rate limits, idempotency keys, and server-side-only constraints\n\nExample prompts:\n\n- \"Add this user to Loops after signup.\"\n- \"Check whether this Loops API key is valid.\"\n- \"Send this event from my Rails app.\"\n- \"Verify Loops webhooks in my Next.js app.\"\n\nSkill file: [skills/loops-api/SKILL.md](./skills/loops-api/SKILL.md)\n\n### `loops-cli`\n\nUse this skill when you need to:\n\n- install or update the Loops CLI\n- authenticate from the terminal and manage stored team keys\n- validate credentials with the CLI\n- run one-off contact, list, event, or transactional-email commands\n- create draft campaigns, update email-message content and upload images from the shell\n- list themes and components for LMX authoring\n- inspect CLI output in text or JSON from the shell\n\nExample prompts:\n\n- \"Install the Loops CLI on macOS.\"\n- \"Log into the CLI for the staging team.\"\n- \"Send a transactional email from the terminal.\"\n\nSkill file: [skills/loops-cli/SKILL.md](./skills/loops-cli/SKILL.md)\n\n### `loops-email-sending-best-practices`\n\nUse this skill when you need to:\n\n- review inbox-placement or sender-reputation problems\n- improve consent flows, list hygiene, or unsubscribe behavior\n- improve subject lines, preview text, sender identity, or template design\n- decide between lifecycle, campaign, and transactional email\n- review a Loops setup for quality or deliverability gaps\n\nExample prompts:\n\n- \"Review this welcome email for deliverability risk.\"\n- \"Should this message be transactional or marketing?\"\n- \"How should we clean up this stale audience?\"\n\nSkill file: [skills/loops-email-sending-best-practices/SKILL.md](./skills/loops-email-sending-best-practices/SKILL.md)\n\n### `loops-lmx`\n\nUse this skill when you need to:\n\n- create or edit Loops email content in LMX\n- design net-new Loops emails from existing Loops themes/components and a visual reference when needed\n- review LMX markup for valid tags, nesting, attributes, and variables\n- use contact properties, components, sections, dynamic links, or dynamic images in Loops email content\n- apply Loops email design guidance while producing valid LMX\n\nExample prompts:\n\n- \"Design a new onboarding email using existing Loops themes/components, then write it in LMX.\"\n- \"Write a product update campaign in LMX.\"\n- \"Convert this lifecycle email copy into Loops LMX.\"\n- \"Review this LMX for compatibility.\"\n\nSkill file: [skills/loops-lmx/SKILL.md](./skills/loops-lmx/SKILL.md)\n\n## Stability notes\n\n- This repo is maintained by Loops.\n- The Loops CLI has its own skill in this repo.\n- The Loops CLI itself is still pre-release and may change faster than the API and SDK docs.\n- The LMX skill tracks documented LMX behavior in the Loops editor and campaign editing API endpoints.\n\n## Versioning and releases\n\nLoops skills are versioned as a single repo-level bundle with GitHub Releases and semver-style tags such as `v1.0.0`.\n\n- Major releases include breaking install or behavior changes, such as renamed or removed skills. Release notes must include migration steps.\n- Minor releases add skills, broaden documented capabilities, or refresh substantial product behavior.\n- Patch releases correct docs, examples, references, or narrow behavior details without changing install names.\n\nUse the GitHub release notes as the changelog for user-facing upgrade guidance.\n\n## Source of truth\n\nThis repo is the installable Loops entry point for agent skills. When product behavior changes faster than this repo, verify against the official Loops resources:\n\n- Docs: https://loops.so/docs\n- API reference: https://loops.so/docs/api-reference/intro\n- JavaScript SDK: https://loops.so/docs/sdks/javascript\n- OpenAPI spec: https://app.loops.so/openapi.json\n- CLI repo: https://github.com/loops-so/cli\n\n## Contributing\n\nPull requests are welcome.\n\nWhen updating a skill:\n\n- keep `SKILL.md` concise and move detailed material into `references/`\n- avoid duplicating the same guidance across `SKILL.md` and references\n- verify product-specific details against official Loops sources\n- re-run `npx skills add . --list` before merging\n\n## Local validation\n\n```bash\ngit clone https://github.com/loops-so/skills.git\ncd skills\nnpx skills add . --list\n```\n\n## Repository structure\n\n```text\nskills/\n  loops-api/\n    SKILL.md\n    references/\n  loops-cli/\n    SKILL.md\n    references/\n  loops-lmx/\n    SKILL.md\n    references/\n  loops-email-sending-best-practices/\n    SKILL.md\n    references/\n.cursor-plugin/plugin.json       # Cursor install\n.claude-plugin/                  # Claude install\n.agents/plugins/marketplace.json # General/Codex marketplace\n```\n",
  "bytes": 9237,
  "sha": "0dcc2b403d56e3066887de9e5b87101d5dc3ecfda6c09aadfde341bd7575935f",
  "repo_slug": "loops-so/skills",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/skl_loops_so_skills_loops_email_sending_best_b03ab74d/readme"
}