Agent skills - install guide

Installation

Three ways to install AgentKit SEO skills into a supported agent environment. Choose the method that matches your setup.

Reading the docs without installing? Every skill page is a human-readable guide you can follow directly - no install required. Installation is only needed if you want an agent to load and invoke the skills.

Browse skill playbooks

Method 1 - npx Available

The canonical one-line install uses the published npm package:

npx agentkit-seo install --provider codex

Replace codex with any supported provider value. The package name is agentkit-seo and the binary is the same name.

You can also run it directly from the GitHub repository:

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

Method 2 - local checkout Maintainers

Clone the repository, then invoke the CLI directly using npx . from the repo root. This is useful for maintainers testing unpublished changes.

# Clone the repo
git clone https://github.com/agentkit-seo/agentkit-seo.git
cd agentkit-seo

# Install to the global default path for your provider
npx . install --provider codex

# Or install into a specific project directory
npx . install --provider codex --project-root /path/to/project

Method 3 - project-local via npm exec Works now

If you have the repository checked out and want to preview generated provider files inside a specific project root without a global install:

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

Supported providers

Pass one of the following values to --provider:

Codex ~/.codex/skills/

Install command

npx agentkit-seo install --provider codex

Invocation

$agentkit-seo-github
$agentkit-seo-linkedin

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

Claude Code ~/.claude/skills/

Install command

npx agentkit-seo install --provider claude-code

Invocation

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

Claude may auto-select from skill metadata, but explicit naming is safer.

Gemini CLI ~/.gemini/extensions/agentkit-seo/

Install command

npx agentkit-seo install --provider gemini-cli

Invocation

/agentkit-seo:github
/agentkit-seo:linkedin
/agentkit-seo:cv-ats

Installs a named extension with TOML command files and the skill folders.

OpenCode ~/.config/opencode/skills/

Install command

npx agentkit-seo install --provider opencode

Invocation

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

Installs skill folders plus flat command wrappers for direct slash invocation.

Shared bundle (requires --target-dir)

Install command

npx agentkit-seo install --provider shared

Invocation

Copy or reference the relevant SKILL.md folder.

No default global path. Use --target-dir to specify where the skill folders go.

Optional flags

--project-root <dir>

Install into a project-relative path instead of the global default.

--target-dir <dir>

Install skill folders into an exact directory. Overrides --project-root for skill placement. Required for shared.

--commands-target-dir <dir>

Override the install path for command wrapper files (OpenCode and Gemini CLI only).

--force

Replace existing skill folders and provider files without prompting.

After installation

Invoke one focused skill by name, provide the private context file path when available, and ask for a specific output: profile audit, rewrite plan, repository checklist, ATS-safe CV pass, metadata review, or maintenance checklist. See the usage guide and the providers page for exact invocation syntax per environment.

Source repository: https://github.com/agentkit-seo/agentkit-seo