Convictional for Claude

This is the source for the Convictional Claude plugin, which connects Claude to your Convictional workspace and ships skills that run guided workflows on your goals, meetings, and organizational data.

Installing the plugin does two things at once:

• Configures the Convictional MCP server (Google OAuth).
• Installs the Convictional skills.

For more information about this plugin, see the Skills page of Convictional guides.

Install

Claude Code

/plugin marketplace add convictional/agent-plugins
/plugin install convictional@convictional

Then run /mcp to authenticate with Google.

Claude Desktop (personal)

In the Claude Desktop Code tab, install from the prompt box exactly as in the CLI:

/plugin marketplace add convictional/agent-plugins
/plugin install convictional@convictional

Or use the + button next to the prompt box and choose Plugins > Add plugin to install from the plugin browser. Then run /mcp to authenticate with Google.

Claude Desktop (Team / Enterprise)

Centrally managed plugins appear in Desktop sessions the same way they do in the CLI. Roll the plugin out through your organization's managed settings (distributed via MDM or the admin console) rather than asking each member to install it.

Contents

.claude-plugin/marketplace.json     # marketplace catalog
references/                         # shared reference files, materialized into each skill at build
plugins/convictional/
  .claude-plugin/plugin.json        # plugin manifest
  .mcp.json                         # declares the hosted Convictional MCP server
  skills/<skill-name>/SKILL.md      # one folder per skill (auto-discovered)

Skills load the shared references skill-relative (references/<file>.md). The canonical copy lives once at the top-level references/; the publish workflow copies it into each skill so the same SKILL.md works inside the plugin and from this checkout during local testing.

Authoring skills

Skills are authored in Convictional's main repository under claude-plugin/ and published here automatically by CI. Do not edit this repository directly. Changes are overwritten on the next sync.

To add a skill (in the main repo):

1. Create plugins/convictional/skills/<skill-name>/SKILL.md. Use kebab-case, prefixed with convictional-, matching the name in the frontmatter:

   ---
   name: convictional-<skill-name>
   description: One or two sentences on when to use this skill and what it does.
   ---
   
   # Title
   
   ## Prerequisites
   
   Requires the Convictional MCP connected (https://guides.convictional.com/integrations/mcp/).
   
   ## Workflow
   
   Step-by-step instructions...

2. Reference the live MCP tool names (current_user, search_content, get_content, list_goals, get_goal, list_subgoals, get_goal_comments). Treat the embedded resource://convictional/guide MCP resource as the source of truth for tool behavior; skills layer task recipes on top rather than restating it.

3. Merge to main; CI publishes the updated plugin here.

Test locally before merging

References are copied into each skill only at build time, so installing straight from a checkout needs that copy done first. From the main repo, run scripts/materialize-references.sh (the copies are gitignored), then add the claude-plugin/ directory as a local marketplace:

/plugin marketplace add ./claude-plugin
/plugin install convictional@convictional