https://github.com/agentkit-seo/agentkit-seo
An open-source framework for engineering your professional discoverability across platform algorithms, search engines, and AI agents. Covers CV/ATS, LinkedIn, GitHub, personal websites, X, and Agent Context Optimization (ACO).
https://github.com/agentkit-seo/agentkit-seo
agent-context agent-skill ai-agents ai-optimization antigravity-cli antigravity-cli-extensions ats career claude-code-skills codex-skills context-engineering cv gemini-cli-extensions gemini-cli-skills linkedin llm-wiki opencode-skills personal-branding resume seo
Last synced: 2 days ago
JSON representation
An open-source framework for engineering your professional discoverability across platform algorithms, search engines, and AI agents. Covers CV/ATS, LinkedIn, GitHub, personal websites, X, and Agent Context Optimization (ACO).
- Host: GitHub
- URL: https://github.com/agentkit-seo/agentkit-seo
- Owner: agentkit-seo
- License: mit
- Created: 2026-04-21T08:47:42.000Z (about 1 month ago)
- Default Branch: main
- Last Pushed: 2026-05-27T14:28:24.000Z (7 days ago)
- Last Synced: 2026-05-27T16:28:10.617Z (7 days ago)
- Topics: agent-context, agent-skill, ai-agents, ai-optimization, antigravity-cli, antigravity-cli-extensions, ats, career, claude-code-skills, codex-skills, context-engineering, cv, gemini-cli-extensions, gemini-cli-skills, linkedin, llm-wiki, opencode-skills, personal-branding, resume, seo
- Language: JavaScript
- Homepage: https://agentkit-seo.github.io/
- Size: 2.14 MB
- Stars: 15
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
- Codeowners: .github/CODEOWNERS
- Security: SECURITY.md
- Agents: AGENTS.md
Awesome Lists containing this project
- awesome-claude-code-toolkit - agentkit-seo - seo install --provider claude-code` | AI agent skill for auditing and optimizing GitHub profiles and repositories. Covers bio, pinned repos, README structure, topics, Copilot instructions, and language stats. | (Skills / Community Skills)
README
Give your career agents a source of truth, platform rules, and a repeatable workflow.
-000000?style=for-the-badge&logo=x)
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.
```text
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:
```bash
npx agentkit-seo install --provider codex
```
Create a private context-file template:
```bash
npx agentkit-seo template context --output ~/.agentkit-seo/my-context.md
```
Ask an agent to fill it from trusted material:
```text
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:
```text
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/-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](./hub/agent-context-optimization/README.md) | [Agent context optimization](https://agentkit-seo.github.io/playbooks/agent-context-optimization/) |
| Improve GitHub profile and repository discoverability | [github](./hub/github/README.md) | [GitHub optimization](https://agentkit-seo.github.io/playbooks/github/) |
| Rewrite a LinkedIn profile for search, recruiters, and AI-readable proof | [linkedin](./hub/linkedin/README.md) | [LinkedIn optimization](https://agentkit-seo.github.io/playbooks/linkedin/) |
| Tailor a CV or resume for ATS parsing and recruiter readability | [cv-ats](./hub/cv-ats/README.md) | [CV and ATS optimization](https://agentkit-seo.github.io/playbooks/cv-ats/) |
| Fix portfolio SEO, AI readability, and indexability | [web-portfolio](./hub/web-portfolio/README.md) | [Web portfolio SEO](https://agentkit-seo.github.io/playbooks/web-portfolio/) |
| Improve X/Twitter profile positioning and posting strategy | [x-twitter](./hub/x-twitter/README.md) | [X/Twitter optimization](https://agentkit-seo.github.io/playbooks/x-twitter/) |
## 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:
```text
~/.agentkit-seo/-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](./.skills/agent-skill/agentkit-seo/wiki/agentkit-seo.md) is the root self-description and graph entrypoint for installed agents.
- [llms.txt](./llms.txt) and [llms-full.txt](./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](./MAINTAINING.md) covers source refresh, wiki maintenance, and validation.
- [AGENTS.md](./AGENTS.md) defines repository instructions for coding agents.
## Install
Install one provider at a time:
```bash
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:
```bash
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:
```bash
npx github:agentkit-seo/agentkit-seo install --provider codex
```
Use an explicit destination when a machine uses a non-default provider location:
```bash
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**
```text
$agentkit-seo-github
```
**Claude Code**
```text
Use the agentkit-seo-linkedin skill to audit my LinkedIn profile.
```
**Gemini CLI**
```text
/agentkit-seo:github
```
**Antigravity CLI**
```text
Use the installed agentkit-seo-github plugin skill to audit my GitHub profile.
```
**OpenCode**
```text
/agentkit-seo-github
```
**Portable skill folders**
```text
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](https://github.com/RenatoMignone) | [LinkedIn](https://www.linkedin.com/in/renato-mignone/) | [Portfolio](https://renatomignone.github.io/) |
| **Elia Innocenti** | [GitHub](https://github.com/eliainnocenti) | [LinkedIn](https://www.linkedin.com/in/eliainnocenti/) | [Portfolio](https://eliainnocenti.github.io/) |
Release history is tracked in [CHANGELOG.md](./CHANGELOG.md). Privacy and security policies are tracked in [PRIVACY.md](./PRIVACY.md) and [SECURITY.md](./SECURITY.md).
If AgentKit SEO is useful, a GitHub star helps others find the project.