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

Why • Quick Start • Modules • Install • Website • How It Works • Status

---

Why It Exists

Most AI agents can rewrite a CV, LinkedIn bio, GitHub README, or portfolio page.

The problem is that they usually rewrite from whatever context happens to be in the chat. That produces generic personal-branding copy, missing facts, repeated questions, and platform advice that does not travel from one agent to another.

AgentKit SEO fixes the starting point with agent context optimization:

• a private agent-context-file for verified career facts
• focused skills for LinkedIn profile optimization, GitHub SEO, CV/ATS resume optimization, portfolio SEO, and X/Twitter profile optimization
• one export/install CLI for Claude Code, Codex, Gemini CLI, OpenCode, and portable SKILL.md usage

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."

Quick Start

Start with the context file, then send one platform through the right skill.

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 a platform skill:

Use agentkit-seo-github to audit my GitHub profile for hiring visibility.
Use my personal context file at the path I provide.

Typical outputs:

• prioritized profile or portfolio audit
• 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 and missing evidence

Agent Context Optimization

Agent context optimization is the layer that keeps agentic AI work from drifting into generic or inconsistent personal-branding output.

Instead of asking every agent to rebuild the user's professional history from scattered prompts, AgentKit SEO starts from a private Markdown context file. That file stores verified facts, links, achievements, constraints, target roles, and positioning notes in a structure that both humans and agents can inspect.

The platform skills then apply surface-specific rules on top of that source of truth:

• LinkedIn gets searchable, recruiter-readable profile structure
• GitHub gets clearer repository metadata, READMEs, topics, and proof links
• CV/ATS gets parser-safe structure and evidence-backed bullets
• portfolio pages get crawlable metadata, structured data, and useful snippets
• X gets bio, pinned-post, and content-positioning guidance

The practical goal is simple: make professional context reusable by agents, while keeping public outputs grounded in facts the user controls.

Modules

Goal	Start here	Public playbook
Build the reusable personal context layer	agent-context-optimization	Agent context optimization
Improve GitHub profile and repository SEO	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	cv-ats	CV and ATS optimization
Fix portfolio SEO and indexability	web-portfolio	Web portfolio SEO
Improve X/Twitter profile and posting strategy	x-twitter	X/Twitter optimization

Install

The canonical install path uses the published npm package:

npx agentkit-seo install --provider codex

Replace codex with any supported provider.

Check the package version and local package layout:

npx agentkit-seo version
npx agentkit-seo doctor

Create a guided private context-file template before asking an agent to rewrite public profiles:

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

Run it directly from the GitHub repository without a local clone:

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

For maintainers testing unpublished changes from a local checkout:

git clone https://github.com/agentkit-seo/agentkit-seo.git
cd agentkit-seo
npx . install --provider codex

Supported install targets:

Provider	Installs to	Activation model
Shared bundle	Portable SKILL.md folders	Manual reuse or packaging
Claude Code	~/.claude/skills/	Skill selection depends on Claude Code's skill loading; explicit skill naming is safest
Codex	CODEX_HOME/skills or ~/.codex/skills/	Use installed skills by name when available; behavior depends on Codex skill support and workspace setup
Gemini CLI	~/.gemini/extensions/agentkit-seo/	Namespaced commands such as /agentkit-seo:linkedin
OpenCode	~/.config/opencode/skills/ plus command wrappers	Native skill loading plus flat commands such as /agentkit-seo-linkedin

Project-local install from a local checkout:

npm exec --package ./. -- agentkit-seo install \
  --provider codex \
  --project-root .

Each install writes an agentkit-seo-install.json manifest in the install root so maintainers and users can inspect the installed package version, provider, skills, commands, and target paths.

How It Works

The workflow moves from scattered raw material to consistent public results in four stages:

1. Raw material: Gather your existing CV, LinkedIn exports, GitHub profile, portfolio URLs, screenshots, and raw project notes.
2. Agent context file: Load your agent with the agent-context-optimization skill and provide your raw material. The agent will distill this into one private, structured source of truth. This file stores your verified identity, target roles, education, experience, projects, metrics, links, constraints, and preferred tone.
3. Platform skills: Provide the resulting context file to an agent loaded with a focused platform skill (such as LinkedIn, GitHub, CV/ATS, or Portfolio).
4. Grounded output: The agent produces an audit, rewrite, patch proposal, or action plan that is consistent across all surfaces and backed by the verified facts in your context file.

It should not be committed to this repository. A portable convention is:

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

The human-readable folders explain the methodology. The runtime skill source lives in .skills/agent-skill/. The export CLI turns that shared source into provider-specific layouts.

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

Invocation

Provider behavior is not identical. Some agents can select installed skills from their metadata, some expose slash commands, and some require you to mention the skill or add provider-specific rules. The shared skill names are the stable contract, but the way you invoke them depends on the provider.

Codex

Mention the installed skill when the environment supports it:

$agentkit-seo-agent-context-optimization
$agentkit-seo-github

Exact activation depends on the Codex environment and installed skill support.

Claude Code

Ask for the installed skill by name. Claude may auto-select from skill metadata, but explicit naming is safer:

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

Gemini CLI

Use the namespaced commands shipped with the Gemini extension bundle:

/agentkit-seo:context
/agentkit-seo:github
/agentkit-seo:linkedin

OpenCode

Use native skill loading or the flat command wrappers:

/agentkit-seo-context
/agentkit-seo-github
/agentkit-seo-linkedin

Other agents

Install or copy the portable SKILL.md folders, then follow that agent's rule or skill system. If the agent cannot load skills automatically, paste or reference the relevant skill instructions manually.

What's Inside

Capability	Typical output
Personal context architecture	Structured agent-context-file that becomes the reusable source of truth
LinkedIn optimization	Section audit, headline/About rewrites, Featured strategy, and activity suggestions
GitHub optimization	Profile and repository discoverability audit with README, topic, naming, and proof-point fixes
CV/ATS optimization	ATS-safe rewrite plan, keyword alignment, bullet improvements, and formatting risks
Web portfolio optimization	SEO/AEO audit, structured-data recommendations, indexability checks, and content improvements
X optimization	Bio, pinned-post, posting strategy, and engagement loop recommendations

Status

Target	Status
Shared skill source	Ready
Install/export CLI	Ready
CLI diagnostics and context template command	Ready
Push and pull request validation workflow	Ready
Claude Code direct install	Ready
Codex direct install	Ready
OpenCode direct install	Ready
Gemini CLI extension install	Ready locally
Published npx agentkit-seo ... package	Shipped
Marketplace / registry distribution	Not shipped yet

First launch focus: cv-ats, github, and linkedin. Other modules can remain beta while packaging, provider support, and the main launch narrative are finished.

Current project notes live in .assets/docs/current-status.md, .assets/docs/project.md, and .assets/docs/architecture-map.md.

Authoring and runtime conventions are defined in .assets/docs/STYLEGUIDE.md and .skills/architecture.md.

Release history is tracked in CHANGELOG.md.

Releasing

Npm is the canonical package registry for AgentKit SEO. GitHub releases mirror npm versions with matching v* tags.

Automated publishing requires an NPM_TOKEN repository secret in GitHub with permission to publish agentkit-seo.

npm run validate
npm version patch
git push origin main --tags

Pushing a version tag such as vX.Y.Z runs the npm publish workflow, verifies the tag matches package.json, validates the package layout, and creates the matching GitHub release after npm publish succeeds.

Who It's For

• developers preparing for job search or promotion cycles
• students turning projects into credible portfolio proof
• founders and freelancers improving public trust signals
• agents that need structured personal context before editing public profiles
• maintainers building portable skills for more than one coding agent

Authors

Maintained by Renato Mignone and Elia Innocenti.

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

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