{"id":50084234,"url":"https://github.com/agentkit-seo/agentkit-seo","last_synced_at":"2026-06-01T13:00:32.122Z","repository":{"id":355805896,"uuid":"1216803148","full_name":"agentkit-seo/agentkit-seo","owner":"agentkit-seo","description":"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).","archived":false,"fork":false,"pushed_at":"2026-05-27T14:28:24.000Z","size":2249,"stargazers_count":15,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-27T16:28:10.617Z","etag":null,"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"],"latest_commit_sha":null,"homepage":"https://agentkit-seo.github.io/","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/agentkit-seo.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2026-04-21T08:47:42.000Z","updated_at":"2026-05-27T14:30:37.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/agentkit-seo/agentkit-seo","commit_stats":null,"previous_names":["agentkit-seo/agentkit-seo"],"tags_count":11,"template":false,"template_full_name":null,"purl":"pkg:github/agentkit-seo/agentkit-seo","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/agentkit-seo%2Fagentkit-seo","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/agentkit-seo%2Fagentkit-seo/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/agentkit-seo%2Fagentkit-seo/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/agentkit-seo%2Fagentkit-seo/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/agentkit-seo","download_url":"https://codeload.github.com/agentkit-seo/agentkit-seo/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/agentkit-seo%2Fagentkit-seo/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33775864,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-01T02:00:06.963Z","response_time":115,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["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"],"created_at":"2026-05-22T18:00:36.857Z","updated_at":"2026-06-01T13:00:32.082Z","avatar_url":"https://github.com/agentkit-seo.png","language":"JavaScript","funding_links":[],"categories":["Skills"],"sub_categories":["Community Skills"],"readme":"\u003cp align=\"center\"\u003e\n  \u003cimg src=\".assets/image/banner.png\" alt=\"AgentKit SEO Banner\" width=\"80%\" /\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cem\u003eGive your career agents a source of truth, platform rules, and a repeatable workflow.\u003c/em\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://www.npmjs.com/package/agentkit-seo\"\u003e\u003cimg src=\"https://img.shields.io/npm/v/agentkit-seo?style=for-the-badge\u0026logo=npm\u0026color=CB3837\" alt=\"npm version\" /\u003e\u003c/a\u003e\n  \u003ca href=\"https://github.com/agentkit-seo/agentkit-seo/actions/workflows/validate.yml\"\u003e\u003cimg src=\"https://img.shields.io/github/actions/workflow/status/agentkit-seo/agentkit-seo/validate.yml?branch=main\u0026style=for-the-badge\u0026logo=githubactions\u0026logoColor=white\u0026label=CI\" alt=\"CI status\" /\u003e\u003c/a\u003e\n  \u003cimg src=\"https://img.shields.io/badge/Agent--Ready-000000?style=for-the-badge\u0026logo=openai\u0026logoColor=white\" alt=\"Agent-Ready\" /\u003e\n  \u003cimg src=\"https://img.shields.io/badge/Markdown--First-4285F4?style=for-the-badge\u0026logo=markdown\u0026logoColor=white\" alt=\"Markdown-First\" /\u003e\n  \u003cimg src=\"https://img.shields.io/badge/LinkedIn-0077B5?style=for-the-badge\u0026logo=linkedin\u0026logoColor=white\" alt=\"LinkedIn\" /\u003e\n  \u003cimg src=\"https://img.shields.io/badge/GitHub-181717?style=for-the-badge\u0026logo=github\u0026logoColor=white\" alt=\"GitHub\" /\u003e\n  \u003cimg src=\"https://img.shields.io/badge/CV_\u0026_ATS-000000?style=for-the-badge\u0026logo=googledocs\u0026logoColor=white\" alt=\"CV \u0026 ATS\" /\u003e\n  \u003cimg src=\"https://img.shields.io/badge/Web_Portfolio-4285F4?style=for-the-badge\u0026logo=googlechrome\u0026logoColor=white\" alt=\"Portfolio\" /\u003e\n  \u003cimg src=\"https://img.shields.io/badge/X_(Twitter)-000000?style=for-the-badge\u0026logo=x\" alt=\"X\" /\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"#why-it-exists\"\u003eWhy\u003c/a\u003e •\n  \u003ca href=\"#who-its-for\"\u003eWho It's For\u003c/a\u003e •\n  \u003ca href=\"#quick-start\"\u003eQuick Start\u003c/a\u003e •\n  \u003ca href=\"#modules\"\u003eModules\u003c/a\u003e •\n  \u003ca href=\"#install\"\u003eInstall\u003c/a\u003e •\n  \u003ca href=\"https://agentkit-seo.github.io/\"\u003eWebsite\u003c/a\u003e •\n  \u003ca href=\"#authors\"\u003eAuthors\u003c/a\u003e\n\u003c/p\u003e\n\n---\n\n## Why It Exists\n\nDevelopers 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.\n\nAgentKit SEO applies that same pattern to a career.\n\nIt 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.\n\nMost 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.\n\nAgentKit SEO provides:\n\n- A private career context file that agents can read before writing.\n- Portable `SKILL.md` modules for LinkedIn, GitHub, CV/ATS, web portfolios, X/Twitter, and context optimization.\n- Curated wiki knowledge for platform constraints, canonical definitions, and known agent failure modes.\n- An install CLI for Claude Code, Codex, Gemini CLI, Antigravity CLI, OpenCode, and portable skill bundles.\n\n```text\nWeak agent output:\n\"I am a passionate developer with experience in many technologies.\"\n\nAgentKit SEO-style output:\n\"Security-focused software engineer building verified, search-ready career systems\nacross GitHub, CVs, LinkedIn, and portfolio sites.\"\n```\n\n## Who It's For\n\n- Developers preparing for job search, promotion, or public credibility work.\n- Students turning projects into credible portfolio proof.\n- Founders and freelancers improving trust signals across public profiles.\n- Agents that need structured personal context before editing public career assets.\n- Maintainers building portable skills for more than one AI coding environment.\n\n## Quick Start\n\nInstall the skills for an agent provider:\n\n```bash\nnpx agentkit-seo install --provider codex\n```\n\nCreate a private context-file template:\n\n```bash\nnpx agentkit-seo template context --output ~/.agentkit-seo/my-context.md\n```\n\nAsk an agent to fill it from trusted material:\n\n```text\nUse agentkit-seo-agent-context-optimization to create my agent-context-file.\nI can provide my CV, LinkedIn sections, GitHub URL, portfolio URL, project notes,\nscreenshots, or any other career material you need.\n```\n\nThen use the right platform skill:\n\n```text\nUse agentkit-seo-github to audit my GitHub profile for hiring visibility.\nUse my personal context file at ~/.agentkit-seo/my-context.md.\n```\n\nTypical outputs include:\n\n- Prioritized profile, repository, CV, or portfolio audits.\n- Evidence-backed rewrite suggestions.\n- ATS-safe CV structure and bullet improvements.\n- GitHub README, topic, pin, and proof-point fixes.\n- LinkedIn headline, About, Experience, Featured, and Skills recommendations.\n- Next actions ranked by impact, evidence, and missing inputs.\n\n## Agent Context Optimization\n\nThe agent-context-file is a private Markdown file, usually kept outside the repository at `~/.agentkit-seo/\u003cname-surname\u003e-seo-context.md`.\n\nIt contains verified identity facts, roles, projects, links, metrics, constraints, target roles, tone, and positioning notes.\n\nPlatform skills read that file first, then adapt the same facts to LinkedIn, GitHub, CV/ATS, web portfolio, or X/Twitter output rules.\n\n## Modules\n\nAgentKit SEO ships one context module and five platform modules.\n\n| Goal | Start here | Public playbook |\n| --- | --- | --- |\n| 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/) |\n| Improve GitHub profile and repository discoverability | [github](./hub/github/README.md) | [GitHub optimization](https://agentkit-seo.github.io/playbooks/github/) |\n| 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/) |\n| 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/) |\n| 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/) |\n| 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/) |\n\n## How It Works\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\".assets/image/workflow.png\" alt=\"AgentKit SEO Workflow: One source of truth, many optimized surfaces\" width=\"100%\" /\u003e\n\u003c/p\u003e\n\nThe workflow moves from scattered raw material to consistent public output:\n\n1. **Raw material:** Gather CVs, LinkedIn sections, GitHub URLs, portfolio URLs, screenshots, exports, and project notes.\n2. **Agent context file:** Use `agentkit-seo-agent-context-optimization` to distill the material into one private Markdown source of truth.\n3. **Platform skill:** Give the context file to a focused skill such as LinkedIn, GitHub, CV/ATS, web portfolio, or X/Twitter.\n4. **Grounded output:** The agent produces an audit, rewrite, patch proposal, or action plan backed by the verified facts in the context file.\n\nKeep the context file private. A portable location is:\n\n```text\n~/.agentkit-seo/\u003cname-surname\u003e-seo-context.md\n```\n\nThis is not a prompt collection. It is an operating manual for agents working on professional identity: verify facts first, then optimize the surface.\n\n## LLM Wiki\n\nWithout 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.\n\n- 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.\n- Wiki entries load conditionally, so agents pull deeper context only when the current task needs it.\n- [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.\n- [llms.txt](./llms.txt) and [llms-full.txt](./llms-full.txt) expose the project map and full wiki bundle for LLM tools.\n\n## Repository Layout\n\nThe repository separates human documentation from runtime agent artifacts:\n\n- `hub/` contains public playbooks, templates, examples, and source notes.\n- `.skills/agent-skill/` contains the canonical portable skill source.\n- `.skills/export/` contains the install, export, doctor, and template CLI.\n- `.skills/providers/` contains provider-specific adapter notes and wrappers.\n- `commands/`, `skills/`, `GEMINI.md`, and `gemini-extension.json` provide the Gemini-compatible root distribution layout.\n\nMaintainer entrypoints:\n\n- [MAINTAINING.md](./MAINTAINING.md) covers source refresh, wiki maintenance, and validation.\n- [AGENTS.md](./AGENTS.md) defines repository instructions for coding agents.\n\n## Install\n\nInstall one provider at a time:\n\n```bash\nnpx agentkit-seo install --provider codex\n```\n\nSupported providers:\n\n| Provider | Installs to | Activation model |\n| --- | --- | --- |\n| `shared` | Portable `SKILL.md` folders | Manual reuse or packaging |\n| `claude-code` | `~/.claude/skills/` | Ask for the installed skill by name |\n| `codex` | `~/.agents/skills/` plus `CODEX_HOME/skills` or `~/.codex/skills/` | Use installed skills by name when available |\n| `gemini-cli` | `~/.gemini/extensions/agentkit-seo/` | Namespaced commands such as `/agentkit-seo:linkedin` |\n| `antigravity` | `~/.gemini/antigravity-cli/plugins/agentkit-seo/` | Plugin layout based on the Gemini-compatible bundle |\n| `opencode` | `~/.config/opencode/skills/` plus command wrappers | Native skill loading plus flat command wrappers |\n\nUseful package commands:\n\n```bash\nnpx agentkit-seo version\nnpx agentkit-seo doctor\nnpx agentkit-seo list providers\nnpx agentkit-seo list skills\n```\n\nInstall from GitHub without a local clone:\n\n```bash\nnpx github:agentkit-seo/agentkit-seo install --provider codex\n```\n\nUse an explicit destination when a machine uses a non-default provider location:\n\n```bash\nnpx agentkit-seo install --provider gemini-cli --target-dir /custom/path/agentkit-seo\n```\n\nEach install writes an `agentkit-seo-install.json` manifest in the install root with the package version, provider, skills, commands, and target paths.\n\n## Invocation\n\nProvider invocation varies. The stable contract is the shared skill name or the provider command wrapper.\n\n**Codex**\n\n```text\n$agentkit-seo-github\n```\n\n**Claude Code**\n\n```text\nUse the agentkit-seo-linkedin skill to audit my LinkedIn profile.\n```\n\n**Gemini CLI**\n\n```text\n/agentkit-seo:github\n```\n\n**Antigravity CLI**\n\n```text\nUse the installed agentkit-seo-github plugin skill to audit my GitHub profile.\n```\n\n**OpenCode**\n\n```text\n/agentkit-seo-github\n```\n\n**Portable skill folders**\n\n```text\nUse the SKILL.md in agentkit-seo-web-portfolio to audit my portfolio site.\n```\n\n## Authors\n\nMaintained by **Renato Mignone** and **Elia Innocenti**.\n\n| Author             | GitHub                                     | LinkedIn                                                | Portfolio                                     |\n| ------------------ | ------------------------------------------ | ------------------------------------------------------- | --------------------------------------------- |\n| **Renato Mignone** | [GitHub](https://github.com/RenatoMignone) | [LinkedIn](https://www.linkedin.com/in/renato-mignone/) | [Portfolio](https://renatomignone.github.io/) |\n| **Elia Innocenti** | [GitHub](https://github.com/eliainnocenti) | [LinkedIn](https://www.linkedin.com/in/eliainnocenti/)  | [Portfolio](https://eliainnocenti.github.io/) |\n\nRelease history is tracked in [CHANGELOG.md](./CHANGELOG.md). Privacy and security policies are tracked in [PRIVACY.md](./PRIVACY.md) and [SECURITY.md](./SECURITY.md).\n\nIf AgentKit SEO is useful, a GitHub star helps others find the project.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fagentkit-seo%2Fagentkit-seo","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fagentkit-seo%2Fagentkit-seo","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fagentkit-seo%2Fagentkit-seo/lists"}