tonyghiani

tonyghiani/ai-essentials

Instructions file CodexOpenCode

Instructions for tonyghiani/ai-essentials, covering ai-essentials, always apply, code style (file-scoped), react (frontend files only) and skills (on demand).

tonyghiani/ai-essentials

Agent

ES|QL expert agent — writes, debugs, and explains Elasticsearch Query Language (ES|QL) queries. Use when the user needs help writing ES|QL queries, understanding ES|QL syntax, debugging query errors, or exploring Elasticsearch data with ES|QL. Examples: top-N aggregations, null field debugging, index joins, Query DSL…

tonyghiani/ai-essentials

Agent

Marco Ghiani's personal blog writer. Writes technical and lifestyle blog posts in Marco's exact voice and style. Use when writing blog posts, articles, or technical content that should read as if Marco wrote it himself. Strips any AI-flavoured writing. Outputs MDX with frontmatter.

tonyghiani/ai-essentials

Cursor rule

Removes AI-flavoured prose patterns from every piece of writing the assistant produces — chat answers, markdown files, code comments, commit messages, PR descriptions, anything text. Bans em-dash stops, corporate slop words, filler transitions, restating moves, and other tells.

tonyghiani/ai-essentials

Cursor rule

Server layering, boundary validation, error handling, and concurrency.

tonyghiani/ai-essentials

Cursor rule

Teaches the agent that numbered user replies map positionally to the previous numbered questions. Accepts short answers as complete. Always-applied behavioral rule.

tonyghiani/ai-essentials

Cursor rule

Folder layout, barrels, type placement, and import paths.

tonyghiani/ai-essentials

Cursor rule

Patterns for avoiding unnecessary useEffect - derive data, use event handlers, reset with keys.

tonyghiani/ai-essentials

Cursor rule

React component structure, props, rendering, and state placement.

tonyghiani/ai-essentials

Cursor rule

Comprehensive rules for useEffect, dependencies, and synchronization patterns.

tonyghiani/ai-essentials

Cursor rule

Rules for using React refs and DOM manipulation correctly.

tonyghiani/ai-essentials

Cursor rule

Test placement, naming, mocking, and assertion style.

tonyghiani/ai-essentials

Cursor rule

TypeScript naming, typing, control flow, and comment conventions.

tonyghiani/ai-essentials

Skill Claude CodeCodex

Audit UI code for accessibility defects that block keyboard and screen-reader users. Invoke when adding or reviewing interactive UI, a form, a modal or flyout, a custom control, or when the user asks about a11y, WCAG, screen readers, or keyboard navigation.

tonyghiani/ai-essentials

Skill Claude CodeCodex

Review an HTTP route, plugin contract, or exported package API for compatibility, validation, and evolvability before it ships. Invoke when adding or changing a route, a plugin setup/start contract, a saved object schema, or a package public export, and when the user asks whether a change is breaking.

tonyghiani/ai-essentials

Skill Claude CodeCodex

Critically review all code changes on the current branch against the base branch, identify improvement opportunities across naming, structure, DRY/KISS/YAGNI, declarative style, self-documenting code, edge cases, testing, and general best practices, then produce a categorized refactoring plan with prioritized action…

tonyghiani/ai-essentials

Skill Claude CodeCodex

Become the maximum expert on a topic, codebase, or architecture before producing any output. Reads a primary source folder (docs/specs), validates against secondary source folders (code), produces a structured report, and asks clarifying questions when something is unclear. Use when the user says "become the expert"…

tonyghiani/ai-essentials

Skill Claude CodeCodex

Check what a dependency or import actually costs before adding it, and find bundle bloat in existing code. Invoke when adding a package, when the user asks whether a dependency is worth it, when a bundle-size check fails in CI, or when reviewing imports in browser-shipped code.

tonyghiani/ai-essentials

Skill Claude CodeCodex

Generate well-formatted GitHub issue content from a brief context, feature request, or bug report. Outputs ready-to-copy Markdown — does not create the issue. Use when the user asks to write a GitHub issue, draft an issue, create issue content, or mentions "gh issue".

tonyghiani/ai-essentials

Skill Claude CodeCodex

Interview the user relentlessly about a plan or design until reaching shared understanding, resolving each branch of the decision tree before any code is written. Use when the user says "grill me", "roast me", "ask me until we agree 100%", "stress-test this plan", "interview me", "ask me clarifying questions"…

tonyghiani/ai-essentials

Skill Claude CodeCodex

Find untranslated user-facing strings and i18n defects that break translation. Invoke when adding UI copy, when an i18n check fails, or when the user asks to review translations, hardcoded strings, or localisation.

tonyghiani/ai-essentials

Skill Claude CodeCodex

Marco's TypeScript and React conventions, extracted from 748 authored commits and confirmed by a 69-question style interview. Invoke before writing or reviewing substantial TS/TSX, when scaffolding a new module, when writing tests, or when a reviewer disagrees with a style choice. Covers components, hooks, types…

tonyghiani/ai-essentials

Skill Claude CodeCodex

Turn logged correction signals into durable memory files. Reads /.claude/memory-signal.jsonl (written automatically by the log-correction-signal hook whenever Marco corrects the assistant or states a preference), groups recurring themes, and proposes memory entries for approval. Invoke when the user says "distill…

tonyghiani/ai-essentials

Skill Claude CodeCodex

Creates pull request descriptions using a fixed template with a concise title, a mixed paragraph-and-bullets summary section, and testing bullets, and can create the PR with gh. Use when the user asks to write a PR description, PR body, pull request summary, or to create a PR.