$git clone https://github.com/agencia-conversion/agentic-seo-skillsAgentic SEO operating system as a Claude Code plugin: project Wiki, DataForSEO workflows, content briefs, technical SEO, and human-approval gates.
| 1 | # Agentic SEO Skills |
| 2 | |
| 3 | Agentic SEO is officially available as a Claude Code plugin. It is a framework for executing SEO with human judgment and agent scale: agents do the research, analysis, content drafting, technical checks, and brain maintenance while logging decisions, evidence, and limitations. The Web Companion is where you read and approve every deliverable. |
| 4 | |
| 5 | ## Install |
| 6 | |
| 7 | Run these commands in a terminal where Claude Code is available as `claude`: |
| 8 | |
| 9 | ```bash |
| 10 | claude plugin marketplace add agencia-conversion/agentic-seo-skills |
| 11 | claude plugin install agentic-seo@agentic-seo-skills-marketplace |
| 12 | ``` |
| 13 | |
| 14 | Then restart Claude Code or run `/reload-plugins` inside an active session. |
| 15 | |
| 16 | ## Start |
| 17 | |
| 18 | ```text |
| 19 | /agentic-seo:start |
| 20 | ``` |
| 21 | |
| 22 | The agent orients the session, runs `project-init` when needed, and routes every substantive deliverable through the Web Companion. For a five-minute walkthrough, see [`docs/getting-started.md`](docs/getting-started.md). |
| 23 | |
| 24 | ## Update |
| 25 | |
| 26 | ```bash |
| 27 | claude plugin marketplace update agentic-seo-skills-marketplace |
| 28 | claude plugin update agentic-seo@agentic-seo-skills-marketplace |
| 29 | ``` |
| 30 | |
| 31 | Then restart Claude Code or run `/reload-plugins`. |
| 32 | |
| 33 | ## How it works |
| 34 | |
| 35 | - Humans own strategy, judgment, and positioning. |
| 36 | - Agents execute repeatable intelligence with explicit criteria. |
| 37 | - The Web Companion is the delivery surface — chat is for short conversation; deliverables are read in the Companion. |
| 38 | - Project knowledge compounds in an Obsidian-compatible brain at `project/brain/`. |
| 39 | - Raw sources, working analysis, deliverables, public content, and authorial knowledge stay in distinct folders. |
| 40 | |
| 41 | Six pillars: Strategy · Brain · Technology · Technical SEO · Content · Data and Analysis. |
| 42 | |
| 43 | Agentic SEO is English-first and officially supports Brazilian Portuguese. Generated prose preserves spelling, accents, and diacritics in the requested language. |
| 44 | |
| 45 | ## Documentation |
| 46 | |
| 47 | | For | Start here | |
| 48 | |---|---| |
| 49 | | Users | [`docs/getting-started.md`](docs/getting-started.md), [`docs/web-companion.md`](docs/web-companion.md), [`docs/brain.md`](docs/brain.md), [`docs/clusters.md`](docs/clusters.md) | |
| 50 | | Contributors | [`docs/architecture.md`](docs/architecture.md), [`docs/contributing.md`](docs/contributing.md), [`docs/refactor-status.md`](docs/refactor-status.md) | |
| 51 | | Specifications | [`docs/specs/`](docs/specs/) | |
| 52 | |
| 53 | The full index is at [`docs/README.md`](docs/README.md). |
| 54 | |
| 55 | ## Local development |
| 56 | |
| 57 | To load the plugin from a local checkout without installing it: |
| 58 | |
| 59 | ```bash |
| 60 | git clone https://github.com/agencia-conversion/agentic-seo-skills.git |
| 61 | cd agentic-seo-skills |
| 62 | npm install |
| 63 | npm run build |
| 64 | claude --plugin-dir . |
| 65 | ``` |
| 66 | |
| 67 | Running plain `claude` from this repository opens the folder as a normal project; plugin skills are only available after loading with `--plugin-dir` or installing through the Claude Code plugin marketplace. |
| 68 | |
| 69 | Validate the manifests and run the tests: |
| 70 | |
| 71 | ```bash |
| 72 | claude plugin validate .claude-plugin/plugin.json |
| 73 | claude plugin validate .claude-plugin/marketplace.json |
| 74 | npm test |
| 75 | node scripts/validate_skills.mjs |
| 76 | ``` |
| 77 | |
| 78 | For the full development workflow, see [`docs/contributing.md`](docs/contributing.md). |
| 79 | |
| 80 | ## Other IDEs and Agents |
| 81 | |
| 82 | Agentic SEO is officially supported only as a Claude Code plugin in the current release. |
| 83 | |
| 84 | Other IDEs and agents can test the portable parts of the framework, but not the complete plugin experience. What can be tested: |
| 85 | |
| 86 | - reading `AGENTS.md` for the cross-agent runtime contract; |
| 87 | - reading `skills/<skill-name>/SKILL.md` files as portable skill instructions; |
| 88 | - running the local CLI commands after cloning the repository; |
| 89 | - using `templates/` and `docs/` as reference material; |
| 90 | - validating source separation, brain layout, and decision-aware workflows manually. |
| 91 | |
| 92 | What is Claude Code-specific and should not be expected to work in other IDEs: `/agentic-seo:*` plugin slash commands, plugin installation through `.claude-plugin/plugin.json`, `SessionStart` hooks and runtime context injection, Claude Code `userConfig` for sensitive settings, plugin-scoped browser handoff behaviour, and marketplace install/update semantics. |
| 93 | |
| 94 | Codex compatibility is best-effort through `AGENTS.md`, `.codex-plugin/plugin.json`, and standard `skills/<skill-name>/SKILL.md` directories. |
| 95 | |
| 96 | ## Release |
| 97 | |
| 98 | Agentic SEO 0.2.0 is distributed through: |
| 99 | |
| 100 | - GitHub repository: `agencia-conversion/agentic-seo-skills` |
| 101 | - Claude Code marketplace: `.claude-plugin/marketplace.json` |
| 102 | - Claude Code plugin id: `agentic-seo@agentic-seo-skills-marketplace` |
| 103 | - Claude plugin release tag: `agentic-seo--v0.2.0` |
| 104 | |
| 105 | ## Security |
| 106 | |
| 107 | Do not commit secrets, raw client data, generated runs, or provider responses from real clients. Credentials belong in Claude Code plugin user configuration or local ignored environment files. |