alexandervashurin/semaphore / .claude/skills/gstack
gstack
FlaggedFast headless browser for QA testing and site dogfooding. Navigate any URL, interact with elements, verify page state, diff before/after actions, take annotated screenshots, check responsive layouts, test forms and uploads, handle dialogs, and assert element states. ~100ms per command. Use when you need to test a feature, verify a deployment, dogfood a user flow, or file a bug with evidence. gstack also includes development workflow skills. When you notice the user is at these stages, suggest the appropriate skill: - Brainstorming a new idea → suggest /office-hours - Reviewing a plan (strategy) → suggest /plan-ceo-review - Reviewing a plan (architecture) → suggest /plan-eng-review - Reviewing a plan (design) → suggest /plan-design-review - Creating a design system → suggest /design-consultation - Debugging errors → suggest /investigate - Testing the app → suggest /qa - Code review before merge → suggest /review - Visual design audit → suggest /design-review - Ready to deploy / create PR → suggest /ship - Post-ship doc updates → suggest /document-release - Weekly retrospective → suggest /retro - Wanting a second opinion or adversarial code review → suggest /codex - Working with production or live systems → suggest /careful - Want to scope edits to one module/directory → suggest /freeze - Maximum safety mode (destructive warnings + edit restrictions) → suggest /guard - Removing edit restrictions → suggest /unfreeze - Upgrading gstack to latest version → suggest /gstack-upgrade If the user pushes back on skill suggestions ("stop suggesting things", "I don't need suggestions", "too aggressive"): 1. Stop suggesting for the rest of this session 2. Run: gstack-config set proactive false 3. Say: "Got it — I'll stop suggesting skills. Just tell me to be proactive again if you change your mind." If the user says "be proactive again" or "turn on suggestions": 1. Run: gstack-config set proactive true 2. Say: "Proactive suggestions are back on."
scripts/analytics.ts
View on GitHub#!/usr/bin/env bun
/**
* analytics — CLI for viewing gstack skill usage statistics.
*
* Reads ~/.gstack/analytics/skill-usage.jsonl and displays:
* - Top skills by invocation count
* - Per-repo skill breakdown
* - Safety hook fire events
*
* Usage:
* bun run scripts/analytics.ts [--period 7d|30d|all]
*/
import * as fs from 'fs';
import * as path from 'path';
import * as os from 'os';
export interface AnalyticsEvent {
skill: string;
ts: string;
repo: string;
event?: string;
pattern?: string;
}
const ANALYTICS_FILE = path.join(os.homedir(), '.gstack', 'analytics', 'skill-usage.jsonl');
/**
* Parse JSONL content into AnalyticsEvent[], skipping malformed lines.
*/
export function parseJSONL(content: string): AnalyticsEvent[] {
const events: AnalyticsEvent[] = [];
for (const line of content.split('\n')) {
const trimmed = line.trim();
if (!trimmed) continue;
try {
const obj = JSON.parse(trimmed);
if (typeof obj === 'object' && obj !== null && typeof obj.ts === 'string') {
events.push(obj as AnalyticsEvent);
}
} catch {
// skip malformed lines
}
}
return events;
}
/**
* Filter events by period. Supports "7d", "30d", and "all".
*/
export function filterByPeriod(events: AnalyticsEvent[], period: string): AnalyticsEvent[] {
if (period === 'all') return events;
const match = period.match(/^(\d+)d$/);
if (!match) return events;
const days = parseInt(match[1], 10);
const cutoff = new Date(Date.now() - days * 24 * 60 * 60 * 1000);
return events.filter(e => {
const d = new Date(e.ts);
return !isNaN(d.getTime()) && d >= cutoff;
});
}
/**
* Format a report string from a list of events.
*/
export function formatReport(events: AnalyticsEvent[], period: string = 'all'): string {
const skillEvents = events.filter(e => e.event !== 'hook_fire');
const hookEvents = events.filter(e => e.event === 'hook_fire');
const lines: string[] = [];
lines.push('gstack skill usage analytics');
lines.push('\u2550'.repeat(39));
lines.push('');
const periodLabel = period === 'all' ? 'all time' : `last ${period.replace('d', ' days')}`;
lines.push(`Period: ${periodLabel}`);
// Top Skills
const skillCounts = new Map<string, number>();
for (const e of skillEvents) {
skillCounts.set(e.skill, (skillCounts.get(e.skill) || 0) + 1);
}
if (skillCounts.size > 0) {
lines.push('');
lines.push('Top Skills');
const sorted = [...skillCounts.entries()].sort((a, b) => b[1] - a[1]);
const maxName = Math.max(...sorted.map(([name]) => name.length + 1)); // +1 for /
const maxCount = Math.max(...sorted.map(([, count]) => String(count).length));
for (const [name, count] of sorted) {
const label = `/${name}`;
const suffix = `${count} invocation${count === 1 ? '' : 's'}`;
const dotLen = Math.max(2, 25 - label.length - suffix.length);
const dots = ' ' + '.'.repeat(dotLen) + ' ';
lines.push(` ${label}${dots}${suffix}`);
}
}
// By Repo
const repoSkills = new Map<string, Map<string, number>>();
for (const e of skillEvents) {
if (!repoSkills.has(e.repo)) repoSkills.set(e.repo, new Map());
const m = repoSkills.get(e.repo)!;
m.set(e.skill, (m.get(e.skill) || 0) + 1);
}
if (repoSkills.size > 0) {
lines.push('');
lines.push('By Repo');
const sortedRepos = [...repoSkills.entries()].sort((a, b) => a[0].localeCompare(b[0]));
for (const [repo, skills] of sortedRepos) {
const parts = [...skills.entries()]
.sort((a, b) => b[1] - a[1])
.map(([s, c]) => `${s}(${c})`);
lines.push(` ${repo}: ${parts.join(' ')}`);
}
}
// Safety Hook Events
const hookCounts = new Map<string, number>();
for (const e of hookEvents) {
if (e.pattern) {
hookCounts.set(e.pattern, (hookCounts.get(e.pattern) || 0) + 1);
}
}
if (hookCounts.size > 0) {
lines.push('');
lines.push('Safety Hook Events');
const sortedHooks = [...hookCounts.entries()].sort((a, b) => b[1] - a[1]);
for (const [pattern, count] of sortedHooks) {
const suffix = `${count} fire${count === 1 ? '' : 's'}`;
const dotLen = Math.max(2, 25 - pattern.length - suffix.length);
const dots = ' ' + '.'.repeat(dotLen) + ' ';
lines.push(` ${pattern}${dots}${suffix}`);
}
}
// Total
const totalSkills = skillEvents.length;
const totalHooks = hookEvents.length;
lines.push('');
lines.push(`Total: ${totalSkills} skill invocation${totalSkills === 1 ? '' : 's'}, ${totalHooks} hook fire${totalHooks === 1 ? '' : 's'}`);
return lines.join('\n');
}
function main() {
// Parse --period flag
let period = 'all';
const args = process.argv.slice(2);
for (let i = 0; i < args.length; i++) {
if (args[i] === '--period' && i + 1 < args.length) {
period = args[i + 1];
i++;
}
}
// Read file
if (!fs.existsSync(ANALYTICS_FILE)) {
console.log('No analytics data found.');
process.exit(0);
}
const content = fs.readFileSync(ANALYTICS_FILE, 'utf-8').trim();
if (!content) {
console.log('No analytics data found.');
process.exit(0);
}
const events = parseJSONL(content);
if (events.length === 0) {
console.log('No analytics data found.');
process.exit(0);
}
const filtered = filterByPeriod(events, period);
console.log(formatReport(filtered, period));
}
if (import.meta.main) {
main();
}
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit. | Stars: 466k | Updated | Claude CodeCodex | Verified | Install |
| rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure. | Stars: 466k | Updated | Claude CodeCodex | Verified | Install |
| rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics. | Stars: 466k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first. | Stars: 193k | Updated | Claude CodeCodex | Verified | Install |