agentic-seo

Agentic SEO Skills

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.

Install

Run these commands in a terminal where Claude Code is available as claude:

claude plugin marketplace add agencia-conversion/agentic-seo-skills
claude plugin install agentic-seo@agentic-seo-skills-marketplace

Then restart Claude Code or run /reload-plugins inside an active session.

Start

/agentic-seo:start

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.

Update

claude plugin marketplace update agentic-seo-skills-marketplace
claude plugin update agentic-seo@agentic-seo-skills-marketplace

Then restart Claude Code or run /reload-plugins.

How it works

• Humans own strategy, judgment, and positioning.
• Agents execute repeatable intelligence with explicit criteria.
• The Web Companion is the delivery surface — chat is for short conversation; deliverables are read in the Companion.
• Project knowledge compounds in an Obsidian-compatible brain at project/brain/.
• Raw sources, working analysis, deliverables, public content, and authorial knowledge stay in distinct folders.

Six pillars: Strategy · Brain · Technology · Technical SEO · Content · Data and Analysis.

Agentic SEO is English-first and officially supports Brazilian Portuguese. Generated prose preserves spelling, accents, and diacritics in the requested language.

Documentation

For	Start here
Users	docs/getting-started.md, docs/web-companion.md, docs/brain.md, docs/clusters.md
Contributors	docs/architecture.md, docs/contributing.md, docs/refactor-status.md
Specifications	docs/specs/

The full index is at docs/README.md.

Local development

To load the plugin from a local checkout without installing it:

git clone https://github.com/agencia-conversion/agentic-seo-skills.git
cd agentic-seo-skills
npm install
npm run build
claude --plugin-dir .

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.

Validate the manifests and run the tests:

claude plugin validate .claude-plugin/plugin.json
claude plugin validate .claude-plugin/marketplace.json
npm test
node scripts/validate_skills.mjs

For the full development workflow, see docs/contributing.md.

Other IDEs and Agents

Agentic SEO is officially supported only as a Claude Code plugin in the current release.

Other IDEs and agents can test the portable parts of the framework, but not the complete plugin experience. What can be tested:

• reading AGENTS.md for the cross-agent runtime contract;
• reading skills/<skill-name>/SKILL.md files as portable skill instructions;
• running the local CLI commands after cloning the repository;
• using templates/ and docs/ as reference material;
• validating source separation, brain layout, and decision-aware workflows manually.

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.

Codex compatibility is best-effort through AGENTS.md, .codex-plugin/plugin.json, and standard skills/<skill-name>/SKILL.md directories.

Release

Agentic SEO 0.2.0 is distributed through:

• GitHub repository: agencia-conversion/agentic-seo-skills
• Claude Code marketplace: .claude-plugin/marketplace.json
• Claude Code plugin id: agentic-seo@agentic-seo-skills-marketplace
• Claude plugin release tag: agentic-seo--v0.2.0

Security

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.