Claude-skill-registry config-reader

Read project config from .agents.yml and .agents.local.yml with local overrides. Supports dot notation for nested fields. Invoke with args "<field> <default>".

install

source · Clone the upstream repo

git clone https://github.com/majiayu000/claude-skill-registry

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/majiayu000/claude-skill-registry "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/data/config-reader" ~/.claude/skills/majiayu000-claude-skill-registry-config-reader && rm -rf "$T"

manifest: skills/data/config-reader/SKILL.md

Config Reader

Read and merge

.agents.yml

and

.agents.local.yml

configuration files. Local config overrides base config.

Requires: yq (

brew install yq

snap install yq

)

Arguments

$ARGUMENTS

format:

<field> [default]

Examples:

```
auto_preview false
```
- get top-level field, default to "false"
```
plan.auto_create_task false
```
- get nested field, default to "false"
```
tech_stack generic
```
- get top-level field, default to "generic"
```
browser.type chrome
```
- get nested browser type
```
toolbox.build_task.design_system_path
```
- get deeply nested field

Execution

Run the config reader script with parsed arguments:

bash scripts/config_reader.sh FIELD DEFAULT

Replace

FIELD

and

DEFAULT

with the parsed arguments.

Return Value

Return ONLY the config value (single line):

```
true
```
```
rails
```
```
github
```

Merge Logic

Local checked first -
```
.agents.local.yml
```
wins if key exists
Fall back to base -
```
.agents.yml
```
if not in local
Default - provided default if neither has the key

Common Fields

Field	Description	Typical Default
`auto_preview`	Auto-open markdown files	`false`
`plan.auto_create_task`	Auto-create tasks from plans	`false`
`tech_stack`	Primary tech stack	`generic`
`task_management`	Task tracking backend	`none`
`workflow`	Git workflow style	`branches`
`default_branch`	Main branch name	`main`
`toolbox.build_task.design_system_path`	Design system location	(none)