Agent-Skills.md

Agent Skills: 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>".

UncategorizedID: majesticlabs-dev/majestic-marketplace/config-reader

Repository

majesticlabs-dev/majestic-marketplace
majesticlabs-devLicense: NOASSERTION
327

Install this agent skill to your local

pnpm dlx add-skill https://github.com/majesticlabs-dev/majestic-marketplace/tree/HEAD/plugins/majestic-engineer/skills/config-reader

Skill Files

Browse the full folder contents for config-reader.

Download Skill

Loading file tree…

plugins/majestic-engineer/skills/config-reader/SKILL.md

Skill Metadata

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

Config Reader

Read and merge .agents.yml and .agents.local.yml configuration files. Local config overrides base config.

Requires: yq (brew install yq or 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 {baseDir}/scripts/config_reader.sh FIELD DEFAULT

Replace FIELD and DEFAULT with the parsed arguments from $ARGUMENTS.

Return Value

Return ONLY the config value (single line):

  • true
  • rails
  • github

Merge Logic

  1. Local checked first - .agents.local.yml wins if key exists
  2. Fall back to base - .agents.yml if not in local
  3. 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 | | toolbox.build_task.design_system_path | Design system location | (none) |