agentation

Automates adding the Agentation toolbar to Next.js layouts by router type.

3|1|Updated Jan 14, 2026
One-click install
npx skills add https://github.com/heyAyushh/stacc --skill agentation-heyayushh
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: agentation
Source: https://github.com/heyAyushh/stacc/tree/main/configs/stacks/nextjs/agentation
Command: npx skills add https://github.com/heyAyushh/stacc --skill agentation-heyayushh

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill automates the integration of the Agentation visual feedback toolbar into Next.js projects, enabling developers to observe user interactions during development without manual setup.

Core Features & Use Cases

  • Framework detection: Identifies Next.js App Router (app/layout.tsx) or Pages Router (pages/_app.js) and applies the appropriate integration.
  • Development-only toolbar: Ensures the Agentation toolbar renders only in development mode to avoid production impact.
  • Minimal setup: Installs the package if missing and injects the toolbar with minimal code changes.

Quick Start

Install the Agentation package if not present: npm install agentation Detect the router type and update the project:

  • For App Router: add to root layout after children: import { Agentation } from "agentation"; {process.env.NODE_ENV === "development" && <Agentation />}
  • For Pages Router: add to _app.js: import { Agentation } from "agentation"; // Add after the App component: {process.env.NODE_ENV === "development" && <Agentation />}

Frequently Asked Questions about agentation

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I add a visual feedback toolbar to my Next.js app?

To add a visual feedback toolbar to your Next.js app, install the agentation package and inject the Agentation component into your root layout or _app.js file, ensuring it only renders during development. The setup detects your router type and applies the correct integration automatically.

Does the Agentation toolbar work with both Next.js App Router and Pages Router?

Yes, the Agentation toolbar works with both Next.js App Router and Pages Router. The setup identifies whether your project uses app/layout.tsx or pages/_app.js and updates the appropriate file to mount the toolbar during development.

What React version do I need to use the Agentation toolbar in Next.js?

You need React 18 compatibility to use the Agentation toolbar in Next.js. The toolbar requires React 18 to render correctly, and the setup ensures the package is installed before injecting the component into your layout.

Will the Agentation toolbar appear in my production Next.js build?

No, the Agentation toolbar will not appear in your production Next.js build. The integration explicitly checks that process.env.NODE_ENV equals development before rendering, ensuring zero impact on production environments.

How do I automatically install and set up Agentation in a Next.js project?

To automatically install and set up Agentation in a Next.js project, run npm install agentation if the package is missing. The setup then injects the toolbar component with minimal code changes into your detected layout file.

Why isn't my visual feedback toolbar rendering in development mode?

Your visual feedback toolbar might not render in development mode if the environment variable NODE_ENV is not set to development or if React 18 compatibility is missing. The integration strictly requires both conditions to mount the toolbar.