From linktree-pack
Execute Linktree secondary workflow: Analytics & Insights. Trigger: "linktree analytics & insights", "secondary linktree workflow".
How this skill is triggered — by the user, by Claude, or both
Slash command
/linktree-pack:linktree-core-workflow-bThis skill is limited to the following tools:
The summary Claude sees in its skill listing — used to decide when to auto-load this skill
Pull click tracking data, measure conversion rates, and extract audience insights from
Pull click tracking data, measure conversion rates, and extract audience insights from
your Linktree profile. Use this workflow when you need to understand which links drive
traffic, where your audience comes from, and how engagement trends over time. This is
the secondary workflow — for link creation and profile management, see
linktree-core-workflow-a.
const analytics = await client.analytics.get({
profile_id: profile.id,
period: 'last_30_days',
granularity: 'daily',
});
console.log(`Total views: ${analytics.views}`);
console.log(`Total clicks: ${analytics.clicks}`);
console.log(`CTR: ${(analytics.clicks / analytics.views * 100).toFixed(1)}%`);
analytics.daily.forEach(d =>
console.log(` ${d.date}: ${d.views} views, ${d.clicks} clicks`)
);
const linkStats = await client.analytics.byLink({
profile_id: profile.id,
period: 'last_7_days',
sort: 'clicks_desc',
});
linkStats.forEach((s, i) =>
console.log(`#${i + 1} ${s.title}: ${s.clicks} clicks (${s.unique_visitors} unique, CTR ${s.ctr}%)`)
);
const audience = await client.analytics.audience({
profile_id: profile.id,
period: 'last_30_days',
});
console.log('Top locations:', audience.locations.slice(0, 5).map(l => `${l.country}: ${l.pct}%`));
console.log('Top referrers:', audience.referrers.slice(0, 5).map(r => `${r.source}: ${r.visits}`));
console.log('Devices:', `Mobile ${audience.devices.mobile}% / Desktop ${audience.devices.desktop}%`);
const report = await client.analytics.report({
profile_id: profile.id,
period: 'last_30_days',
metrics: ['views', 'clicks', 'ctr', 'unique_visitors', 'top_referrers'],
format: 'json',
});
console.log(`Report period: ${report.start_date} to ${report.end_date}`);
console.log(`Highest CTR link: ${report.top_link.title} (${report.top_link.ctr}%)`);
console.log(`Total unique visitors: ${report.unique_visitors}`);
| Issue | Cause | Fix |
|---|---|---|
401 Unauthorized | Expired or invalid bearer token | Re-authenticate via OAuth flow |
403 Analytics unavailable | Free-tier profile without analytics | Upgrade to Pro plan for analytics access |
404 Profile not found | Wrong profile_id | Verify with client.profiles.list() |
422 Invalid period | Unsupported date range format | Use last_7_days, last_30_days, or ISO dates |
| Empty daily array | Profile has zero traffic in range | Widen the date range or verify profile is published |
A successful workflow produces daily view/click time series, a ranked list of link performance with CTR, audience demographics broken down by location, referrer, and device type, and a summary conversion report identifying top-performing links.
See linktree-sdk-patterns for OAuth setup and rate-limit handling.
npx claudepluginhub flight505/skill-forge --plugin linktree-packCreates, edits, and optimizes skills for Claude Code, including drafting, evaluating with test prompts, iterating on performance, and improving skill descriptions for better triggering accuracy.