Skip to main content

​
Overview

A global configuration repository lets you maintain shared skills, hooks, and sub-agents in one place and have them automatically loaded into every coding agent session across your workspace — regardless of which repository the agent is working in. Configure it at Dashboard → Settings → Global Configuration.

​
What gets loaded

When a session starts, Blocks loads the following from your global configuration repository:
  • Skills from .claude/skills/, .codex/skills/, and .agents/skills/
  • Hooks for customizing agent behavior
  • Sub-agents configuration
These are merged with skills from the active repository and any skills created directly in the dashboard. See Skills for how merging works.

​
Setting a global configuration repository

  1. Go to Dashboard → Settings → Global Configuration
  2. Select a repository from the dropdown — only repositories already connected to your workspace are shown
  3. Click Save
To remove the global configuration repository, select the blank option at the top of the dropdown and save.
Changes take effect in new sessions. Existing sessions are not affected.

​
When to use this

A global configuration repository is useful when:
  • Multiple repositories need the same set of skills (e.g., /review-security, /gen-tests)
  • You want to enforce consistent agent behavior across your workspace
  • Your team maintains shared hooks or sub-agent configurations
For repository-specific skills that only apply to one project, commit a SKILL.md directly to that repository instead. See Skills for details.