# Marker Insights

> Aggregate Marker.io website feedback into recurring patterns. Use when asked to find the most common issues on a site, which pages get the most feedback, recurring content problems, or the content-vs-bug split across many Marker.io reports, and produce a prioritized brief for a website team or agency. Read-only: it analyzes and reports, it does not change issues.

- **Type:** Skill
- **Install:** `agentstack add skill-marker-io-mcp-skills-marker-insights`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [marker-io](https://agentstack.voostack.com/s/marker-io)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [marker-io](https://github.com/marker-io)
- **Source:** https://github.com/marker-io/mcp-skills/tree/main/claude/skills/marker-insights
- **Website:** https://marker.io

## Install

```sh
agentstack add skill-marker-io-mcp-skills-marker-insights
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# marker-insights

Aggregate Marker.io website feedback into recurring patterns and a prioritized brief: what keeps coming
back, which pages attract the most reports, and how much is content versus functional. Built for digital
agencies and in-house website teams, where most feedback is content (typos, copy, images, links) and the
rest is functional bugs.

## When to use

"What are the most common issues on the site", "which pages get the most feedback", "are there recurring
content problems", "what's our content-vs-bug split", "feedback health of <site>". This is pattern
analysis across many reports, not per-issue triage (`marker-triage`) or fixing one report
(`marker-bug-to-fix`).

## Steps

1. Resolve the project(s) and read `project_get` for the site's `websiteUrls` (used to turn each issue
   URL into a page). For a multi-site view, repeat and pool the results.
2. Pull a wide window with `issues_list` (paginate `limit`/`offset` fully; usually weeks to months). Keep
   fields lean: `markerId`, `title`, `status`, `url`, `createdAt`. Drill into `issue_get` /
   `issue_get_context` / `issue_get_screenshot` only on a sample per cluster.
3. Classify every report as **content** (typo, copy/wording, wrong number or fact, image/media, broken
   link, layout/spacing, translation) or **functional** (form, navigation, JavaScript error, responsive
   break, performance). Marker does not expose an issue's type to read, so infer it from the title, page
   URL, and — when unclear — the screenshot.
4. Cluster within each class by page (from the URL) and by theme. Count frequency and note severity,
   weighing how prominent the page is (a homepage typo is low-severity but high-visibility).
5. Identify: the highest-feedback pages, recurring content problems (the same fix showing up again and
   again), the content-vs-functional ratio, the trend over time (bucket by `createdAt`), and any single
   root cause behind many reports (e.g. one stale data source feeding several pages).

## Output

A prioritized brief (markdown): the content-vs-functional split, a per-page hotspot list, the top
recurring themes with frequency, severity, and representative examples (Marker links), trend direction,
and a suggested action per theme (fix now / batch / watch). Rank by impact x frequency.

This skill is read-only. It does not change any issue.

## Operating rules

This skill drives the Marker.io MCP. Read tools: `projects_list`, `project_get`, `project_list_users`,
`list_issue_types`, `issues_list`, `issue_get`, `issue_get_context`, `issue_get_screenshot`,
`issue_get_attachments`, `issue_get_console_log`, `issue_get_network_request`. Write tools:
`issue_update_status`, `issue_update_assignee`, `issue_update_priority`, `issue_update_type`,
`comment_create`.

1. **Resolve the project first.** Call `projects_list` (filter with `searchText`). If more than one
   could match, show the candidates and ask which one. Never guess a `projectId`.
2. **Discover before you write.** Status and issue-type strings are project-specific. Call
   `list_issue_types` and `project_get` for valid values before any `issue_update_*`. Get user IDs
   from `project_list_users` before assigning or @mentioning.
3. **Read cheap, drill deep only when it matters.** Start from `issue_get_context` summaries; fetch a
   specific `issue_get_console_log(logIndex)` / `issue_get_network_request(requestIndex)` or
   `issue_get_screenshot` only when it changes a decision.
4. **Propose, then apply.** Before any write, print a table of the planned changes (issue, field,
   old to new). Apply via the `*_update_*` / `comment_create` tools only after the user confirms.
   Default comment visibility to `Member-only` unless the reporter should see it.
5. **Respect the limits.** `issues_list` does not return assignee (fetch per-issue via `issue_get`).
   The MCP cannot create Marker.io issues. Never embed tokens; rely on the configured MCP auth.

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [marker-io](https://github.com/marker-io)
- **Source:** [marker-io/mcp-skills](https://github.com/marker-io/mcp-skills)
- **License:** MIT
- **Homepage:** https://marker.io

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-marker-io-mcp-skills-marker-insights
- Seller: https://agentstack.voostack.com/s/marker-io
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.