Persona

Build a portfolio that feels like you—not a template with your name pasted in.

Persona is a starter kit for AI coding agents. You share your goals, work, and visual taste in a local setup page. Your agent uses that context to research, propose a design, build the site, and help you publish it.

1. Create a repository from this template.
2. Clone your new repository.
3. Run:

./setup.sh

Persona opens a local setup page, saves your answers to profile.yaml, and then opens the coding agent you choose.

Requirements: Node.js 20.18 or newer, npm, Git, and a coding agent.

• Learns who you are from your profile and optional materials.
• Researches only when you and your agent choose to.
• Proposes a visual direction before changing the site.
• Builds a custom Next.js portfolio instead of filling a fixed template.
• Checks the result before helping you publish it.

Persona includes auto-discovered instructions for Claude Code, Gemini CLI, Codex, Cursor, and Antigravity. Devin and other agents can read .agent/persona/SKILL.md directly.

Persona does not install agents, edit global agent settings, or ask for access tokens. Install and sign in to your chosen agent through its official instructions.

The setup page runs at 127.0.0.1 and is disabled in production builds. Your profile and uploaded materials are written into your repository. Persona does not send them anywhere by itself.

Anything committed or pushed to a public repository becomes public. Review profile.yaml and materials/ before publishing.

npm run dev          # Open the local site
npm run check        # Lint, type-check, test, check setup, and build
npm run build        # Make a production build
./setup.sh            # Create or edit your profile

Vercel is the simplest option: import your repository in Vercel and deploy it as a Next.js project.

The included GitHub Actions deployments are manual on purpose, so a fresh template does not fail or publish unexpectedly. See .agent/skills/deploy/SKILL.md for Vercel and GitHub Pages steps.

persona/
├── .agent/           # Shared workflow and design guidance
├── materials/        # Optional resume, images, and project material
├── src/app/          # Next.js site and local setup page
├── src/lib/          # Config, upload, and safety helpers
├── AGENTS.md         # Codex instructions
├── CLAUDE.md         # Claude Code instructions
├── GEMINI.md         # Gemini CLI instructions
├── profile.yaml      # Created locally by setup
└── setup.sh          # Local onboarding

Run npm install once, then npm run check before opening a pull request.

MIT