Give your career agents a source of truth, platform rules, and a repeatable workflow.

Why • Who It's For • Quick Start • Modules • Install • Website • Authors

---

Why It Exists

Developers already understand CLAUDE.md, AGENTS.md, and repo-level context files: put one in a project, and an AI agent can understand the codebase before it edits anything.

AgentKit SEO applies that same pattern to a career.

It gives agents a private Markdown source of truth called an agent-context-file. That file stores verified facts about experience, projects, metrics, target roles, constraints, links, and positioning. Every platform skill then works from the same context instead of rebuilding professional history from scratch in every chat.

Most AI agents can rewrite a CV, LinkedIn bio, GitHub README, or portfolio page. The hard part is making the output factual, consistent, platform-aware, and reusable across tools.

AgentKit SEO provides:

• A private career context file that agents can read before writing.
• Portable SKILL.md modules for LinkedIn, GitHub, CV/ATS, web portfolios, X/Twitter, and context optimization.
• Curated wiki knowledge for platform constraints, canonical definitions, and known agent failure modes.
• An install CLI for Claude Code, Codex, Gemini CLI, Antigravity CLI, OpenCode, and portable skill bundles.

Weak agent output:
"I am a passionate developer with experience in many technologies."

AgentKit SEO-style output:
"Security-focused software engineer building verified, search-ready career systems
across GitHub, CVs, LinkedIn, and portfolio sites."

Who It's For

• Developers preparing for job search, promotion, or public credibility work.
• Students turning projects into credible portfolio proof.
• Founders and freelancers improving trust signals across public profiles.
• Agents that need structured personal context before editing public career assets.
• Maintainers building portable skills for more than one AI coding environment.

Quick Start

Install the skills for an agent provider:

npx agentkit-seo install --provider codex

Create a private context-file template:

npx agentkit-seo template context --output ~/.agentkit-seo/my-context.md

Ask an agent to fill it from trusted material:

Use agentkit-seo-agent-context-optimization to create my agent-context-file.
I can provide my CV, LinkedIn sections, GitHub URL, portfolio URL, project notes,
screenshots, or any other career material you need.

Then use the right platform skill:

Use agentkit-seo-github to audit my GitHub profile for hiring visibility.
Use my personal context file at ~/.agentkit-seo/my-context.md.

Typical outputs include:

• Prioritized profile, repository, CV, or portfolio audits.
• Evidence-backed rewrite suggestions.
• ATS-safe CV structure and bullet improvements.
• GitHub README, topic, pin, and proof-point fixes.
• LinkedIn headline, About, Experience, Featured, and Skills recommendations.
• Next actions ranked by impact, evidence, and missing inputs.

Agent Context Optimization

The agent-context-file is a private Markdown file, usually kept outside the repository at ~/.agentkit-seo/<name-surname>-seo-context.md.

It contains verified identity facts, roles, projects, links, metrics, constraints, target roles, tone, and positioning notes.

Platform skills read that file first, then adapt the same facts to LinkedIn, GitHub, CV/ATS, web portfolio, or X/Twitter output rules.

Modules

AgentKit SEO ships one context module and five platform modules.

Goal	Start here	Public playbook
Build the reusable personal context layer	agent-context-optimization	Agent context optimization
Improve GitHub profile and repository discoverability	github	GitHub optimization
Rewrite a LinkedIn profile for search, recruiters, and AI-readable proof	linkedin	LinkedIn optimization
Tailor a CV or resume for ATS parsing and recruiter readability	cv-ats	CV and ATS optimization
Fix portfolio SEO, AI readability, and indexability	web-portfolio	Web portfolio SEO
Improve X/Twitter profile positioning and posting strategy	x-twitter	X/Twitter optimization

How It Works

The workflow moves from scattered raw material to consistent public output:

1. Raw material: Gather CVs, LinkedIn sections, GitHub URLs, portfolio URLs, screenshots, exports, and project notes.
2. Agent context file: Use agentkit-seo-agent-context-optimization to distill the material into one private Markdown source of truth.
3. Platform skill: Give the context file to a focused skill such as LinkedIn, GitHub, CV/ATS, web portfolio, or X/Twitter.
4. Grounded output: The agent produces an audit, rewrite, patch proposal, or action plan backed by the verified facts in the context file.

Keep the context file private. A portable location is:

~/.agentkit-seo/<name-surname>-seo-context.md

This is not a prompt collection. It is an operating manual for agents working on professional identity: verify facts first, then optimize the surface.

LLM Wiki

Without a knowledge layer, agents guess at platform constraints from training data: ATS parser behavior, LinkedIn field limits, GitHub Linguist rules, and other details that change or depend on context. That guessing produces confident but wrong advice. AgentKit SEO's wiki layer follows Andrej Karpathy's LLM Wiki concept: a knowledge base the LLM reads, not one it writes. A maintainer-only wiki refresh skill exists in the source tree for local source audits; the installed user bundle still ships only the runtime skills.

• Every skill ships with per-module Markdown entries for canonical definitions, platform constraints with confidence labels, known failure modes, evidence rules, and audit output rules.
• Wiki entries load conditionally, so agents pull deeper context only when the current task needs it.
• agentkit-seo/wiki/agentkit-seo.md is the root self-description and graph entrypoint for installed agents.
• llms.txt and llms-full.txt expose the project map and full wiki bundle for LLM tools.

Repository Layout

The repository separates human documentation from runtime agent artifacts:

• hub/ contains public playbooks, templates, examples, and source notes.
• .skills/agent-skill/ contains the canonical portable skill source.
• .skills/export/ contains the install, export, doctor, and template CLI.
• .skills/providers/ contains provider-specific adapter notes and wrappers.
• commands/, skills/, GEMINI.md, and gemini-extension.json provide the Gemini-compatible root distribution layout.

Maintainer entrypoints:

• MAINTAINING.md covers source refresh, wiki maintenance, and validation.
• AGENTS.md defines repository instructions for coding agents.

Install

Install one provider at a time:

npx agentkit-seo install --provider codex

Supported providers:

Provider	Installs to	Activation model
shared	Portable SKILL.md folders	Manual reuse or packaging
claude-code	~/.claude/skills/	Ask for the installed skill by name
codex	~/.agents/skills/ plus CODEX_HOME/skills or ~/.codex/skills/	Use installed skills by name when available
gemini-cli	~/.gemini/extensions/agentkit-seo/	Namespaced commands such as /agentkit-seo:linkedin
antigravity	~/.gemini/antigravity-cli/plugins/agentkit-seo/	Plugin layout based on the Gemini-compatible bundle
opencode	~/.config/opencode/skills/ plus command wrappers	Native skill loading plus flat command wrappers

Useful package commands:

npx agentkit-seo version
npx agentkit-seo doctor
npx agentkit-seo list providers
npx agentkit-seo list skills

Install from GitHub without a local clone:

npx github:agentkit-seo/agentkit-seo install --provider codex

Use an explicit destination when a machine uses a non-default provider location:

npx agentkit-seo install --provider gemini-cli --target-dir /custom/path/agentkit-seo

Each install writes an agentkit-seo-install.json manifest in the install root with the package version, provider, skills, commands, and target paths.

Invocation

Provider invocation varies. The stable contract is the shared skill name or the provider command wrapper.

Codex

$agentkit-seo-github

Claude Code

Use the agentkit-seo-linkedin skill to audit my LinkedIn profile.

Gemini CLI

/agentkit-seo:github

Antigravity CLI

Use the installed agentkit-seo-github plugin skill to audit my GitHub profile.

OpenCode

/agentkit-seo-github

Portable skill folders

Use the SKILL.md in agentkit-seo-web-portfolio to audit my portfolio site.

Authors

Maintained by Renato Mignone and Elia Innocenti.

Author	GitHub	LinkedIn	Portfolio
Renato Mignone	GitHub	LinkedIn	Portfolio
Elia Innocenti	GitHub	LinkedIn	Portfolio

Release history is tracked in CHANGELOG.md. Privacy and security policies are tracked in PRIVACY.md and SECURITY.md.

If AgentKit SEO is useful, a GitHub star helps others find the project.