> For the complete documentation index, see [llms.txt](https://docs.luciq.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.luciq.ai/product-guides-and-integrations/product-guides/ai-features/agent-skills.md).

# Agent Skills

Curated skills that teach AI coding agents how to use Luciq the way an experienced mobile engineer would.

Skills are instruction sets your agent can follow when you ask it to set up, debug, or migrate Luciq in your project. They live alongside your project rules (in Cursor, Claude Code, Codex, or any agent that supports the [Agent Skills](https://agentskills.io) format) and activate automatically when the conversation matches.

## Skills vs MCP Server vs AI Coding Agent Integration

These three pieces work together but solve different problems:

| Surface                                                                                                 | What it gives the agent                                                                                            | When to use                                                                                               |
| ------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------- |
| [**Luciq MCP Server**](/product-guides-and-integrations/product-guides/ai-features/luciq-mcp-server.md) | **Tools.** Read access to your crashes, hangs, bugs, occurrences, and reviews.                                     | The agent needs production data to investigate issues or answer questions.                                |
| [**AI Coding Agent Integration**](/getting-started/luciq-ai-integration.md)                             | **End-to-end SDK setup workflow.** Pinned dependency, init, invocation, masking, MCP wiring, smoke build.          | The user is integrating Luciq for the first time, or onboarding a new platform.                           |
| **Agent Skills** *(this page)*                                                                          | **Methodology.** The investigation patterns, decision points, and pitfalls that turn raw MCP data into a real fix. | The agent has tools and data but you want it to investigate the way an experienced mobile engineer would. |

Tools without methodology produces drive-by API calls. Methodology without tools is theory. You want all three.

## Available Skills

| Skill                                                                                                                        | Use it when                                                                                                                                                                                                                                         |
| ---------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [**`luciq-setup`**](/product-guides-and-integrations/product-guides/ai-features/agent-skills/luciq-setup.md)                 | Adding Luciq to a new project for the first time. *(Wraps the existing AI Coding Agent integration flow.)*                                                                                                                                          |
| [**`luciq-onboard`**](/product-guides-and-integrations/product-guides/ai-features/agent-skills/luciq-onboard.md)             | Walking through which Luciq products fit your app after initial setup. The agent reads your repo, surfaces conflicts with existing mobile observability SDKs, and guides you through configuring and activating each product with cited reasoning.  |
| [**`luciq-masking-rules`**](/product-guides-and-integrations/product-guides/ai-features/agent-skills/luciq-masking-rules.md) | Auditing PII masking posture and preparing for a compliance framework (HIPAA, GDPR, PCI-DSS, SOC 2, CCPA, FERPA). The agent scans all three masking layers, surfaces gaps with citations, and walks you through closing them one control at a time. |
| [**`luciq-debug`**](/product-guides-and-integrations/product-guides/ai-features/agent-skills/luciq-debug.md)                 | Investigating a Luciq production signal end to end — crash, hang, user-reported bug, or APM performance issue. The agent pulls the right MCP context, maps it to your local code, and proposes a fix grounded in evidence.                          |
| [**`luciq-group-bugs`**](/product-guides-and-integrations/product-guides/ai-features/agent-skills/luciq-group-bugs.md)       | Consolidating your bug list by marking duplicates according to your own grouping logic. The agent compiles your rule into an explainable key, renders a dry-run plan, and only merges after you approve it.                                         |
| [**`luciq-migrate`**](/product-guides-and-integrations/product-guides/ai-features/agent-skills/luciq-migrate.md)             | Moving a project from the legacy Instabug SDK to Luciq, or upgrading between Luciq SDK versions. *(Wraps the existing migration hub.)*                                                                                                              |
| [**`luciq-verify`**](/product-guides-and-integrations/product-guides/ai-features/agent-skills/luciq-verify.md)               | Verifying a Luciq SDK upgrade actually works before you ship. The agent builds a debug-variant harness, drives a deterministic smoke, and audits the captured crash, bug, and APM data via the Luciq MCP to produce a pass/fail report.             |
| [**`luciq-readout`**](/product-guides-and-integrations/product-guides/ai-features/agent-skills/luciq-readout.md)             | Generating a shareable, audience-tailored readout of app health for a chosen audience — C-suite, VP, PM, EM, or QA — with every figure cited to its Luciq MCP source.                                                                               |
| [**`luciq-alert-config`**](/product-guides-and-integrations/product-guides/ai-features/agent-skills/luciq-alert-config.md)   | Creating, changing, or inspecting a specific Luciq alert. The agent authors a valid payload by reading the app's alert catalog first, and never guesses an id, threshold, or unstated value.                                                        |
| [**`luciq-alert-gaps`**](/product-guides-and-integrations/product-guides/ai-features/agent-skills/luciq-alert-gaps.md)       | Finding what you're not monitoring. The agent cross-references current metric health against your existing alert rules and proposes alerts only for metrics that are both unhealthy and uncovered.                                                  |
| [**`luciq-alert-noise`**](/product-guides-and-integrations/product-guides/ai-features/agent-skills/luciq-alert-noise.md)     | Reducing noisy or spammy Luciq alerts. The agent inspects each alert's trigger frequency and recommends targeted fixes without ever silencing a safety-critical alert.                                                                              |

## Install

Add the Luciq marketplace and install all the skills in one step:

```
/plugin marketplace add luciqai/agent-skills
/plugin install luciq-skills@luciq.ai
```

Works in **Claude Code** and **Cursor**. The plugin install also wires up the [Luciq MCP server](/product-guides-and-integrations/product-guides/ai-features/luciq-mcp-server.md), so the skills have production data from day one.

After install, the skills become available as `/luciq-skills:luciq-setup`, `/luciq-skills:luciq-onboard`, `/luciq-skills:luciq-masking-rules`, `/luciq-skills:luciq-debug`, `/luciq-skills:luciq-group-bugs`, `/luciq-skills:luciq-migrate`, `/luciq-skills:luciq-verify`, `/luciq-skills:luciq-readout`, `/luciq-skills:luciq-alert-config`, `/luciq-skills:luciq-alert-gaps`, and `/luciq-skills:luciq-alert-noise`.

For other agents, install via npm:

```bash
npx luciq-skills install            # project-local (.claude/skills/)
npx luciq-skills install --global   # all projects (~/.claude/skills/)
```

Or copy the [`SKILL.md` files](https://github.com/luciqai/agent-skills/tree/main/plugins/luciq-skills/skills) directly from the public repo. The full SKILL.md is also reproduced on each skill page below.

## Prerequisites

* A Luciq account and at least one app token.
* An AI coding agent that supports the [Agent Skills](https://agentskills.io) format. Claude Code, Cursor, Codex, or any other compatible client.
* For `luciq-debug`, `luciq-group-bugs`, `luciq-readout`, `luciq-verify`, `luciq-alert-config`, `luciq-alert-gaps`, and `luciq-alert-noise`: the [Luciq MCP Server](/product-guides-and-integrations/product-guides/ai-features/luciq-mcp-server.md) configured and authenticated. The `luciq-setup` skill wires this for you.

## How a skill activates

Skills declare *when* they apply via their description and triggering phrases. You don't `/run` them; you describe what you want, and the agent picks the right skill on its own.

For example, asking the agent *"why is this iOS crash happening, Luciq says it's only on iOS 18"* activates `luciq-debug`. Asking *"add Luciq to this project"* activates `luciq-setup`. The agent reads the skill, follows its methodology, and pulls in MCP data when the skill calls for it.

## Contributing & feedback

The skills are maintained in the public [`luciqai/agent-skills`](https://github.com/luciqai/agent-skills) repo and reviewed by our SDK leads before they ship. Spotted something inaccurate, or have a workflow you'd like a skill for? Open an issue on the repo or reach out to your Luciq contact.

We're shipping skills as we validate them. The bar is high on purpose: skills feed into agents that write code in your repo, so accuracy beats coverage.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.luciq.ai/product-guides-and-integrations/product-guides/ai-features/agent-skills.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.