Imported from carlislejd/analystkit (AGENTS.md). Install upstream with npx skills add carlislejd/analystkit. Copyright stays with the author.

AnalystKit Agent Instructions

AnalystKit creates QR report charts as editable vector SVGs. The September 15, 2026 handoff is authoritative: analystkit/colors.py, typography.py, and layout.py own every visual rule. Rendering code consumes these modules.

These are the only supported presets. Unknown names fail explicitly. The only chart profile is report; single-page is its default. Exported dimensions include the plot, ticks, and labels.

All chart text is PP Neue Montreal Mono Book, weight 375. One font size applies to every role within each canvas: performance 8 pt, single-page 10 pt, new-flows 9 pt, portfolio-performance 7 pt, and half-page 8 pt. These sizes are owned by typography.REPORT_FONT_SIZES_PT; only type scales, while design geometry stays fixed. SVGs use physical point dimensions while retaining Plotly's CSS-pixel viewBox. The complete bundled Mono Book font is embedded, and labels remain editable text. Illustrator editing requires the same bundled font on the editing computer; embedding alone does not establish Illustrator font support.

Charts omit headline, subtitle, source, and visible legend. The document owns those elements. Ordered legend specifications are stored in chart metadata. X ticks connect to the bottom axis; labels sit between tick boundaries. Axis label spacing is 6.12 pt from the axis; data-label spacing is 5.4 pt. Colors depend on series count, with Bitwise using its separate black role.

Work sequence

1. Read skills/analystkit/SKILL.md, DESIGN_COMPONENTS.md, CHART_RECIPES.md, and AI_REFERENCE.md. For full documents also read REPORT_RECIPES.md.
2. Import as import analystkit as ak.
3. Normalize data; build a Plotly figure; apply report and a named preset.
4. Attach JSON-safe metadata, validate, and export SVG bundles.
5. For refresh scripts expose build_figure(start_date=None, end_date=None).
6. Keep I/O outside import time. Never commit secrets, private data, or generated outputs without explicit authorization.
7. Run appropriate tests and inspect static output for clipping, typography, physical dimensions, and consistency across the five presets.

Full HTML/PDF documents use the report builder and design-owned document shell. Their cover, titles, sources and page furniture remain outside chart SVGs.