Agent skill

json-config-loader

Configuration file parsing patterns for bash scripts (INI, key=value, JSON)

View SKILL.md on GitHub Repository
Stars 4
Forks 4

Install this agent skill to your Project

npx add-skill https://github.com/vamseeachanta/workspace-hub/tree/main/.claude/skills/_core/bash/json-config-loader

SKILL.md

Json Config Loader

When to Use This Skill

✅ Use when:

  • Loading configuration from files into bash scripts
  • Parsing key=value or INI-style configuration files
  • Working with JSON data using jq
  • Generating JSON reports from bash
  • Managing configuration with associative arrays

❌ Avoid when:

  • Complex nested configuration (consider Python instead)
  • Real-time configuration changes (use a daemon)
  • Configuration with complex validation rules

Complete Example: Config Manager

Full configuration management with multiple formats:

bash
#!/bin/bash
# ABOUTME: Universal configuration manager
# ABOUTME: Supports key=value, JSON, and environment overrides

set -e

# ─────────────────────────────────────────────────────────────────
# Configuration Storage
# ─────────────────────────────────────────────────────────────────

declare -A CONFIG
CONFIG_FILE=""
CONFIG_FORMAT=""

# ─────────────────────────────────────────────────────────────────
# Format Detection
# ─────────────────────────────────────────────────────────────────

detect_format() {
    local file="$1"

    case "${file##*.}" in

*See sub-skills for full details.*

## Resources

- [jq Manual](https://stedolan.github.io/jq/manual/)
- [yq Documentation](https://mikefarah.gitbook.io/yq/)
- [Bash Associative Arrays](https://www.gnu.org/software/bash/manual/html_node/Arrays.html)

---

## Version History

- **1.0.0** (2026-01-14): Initial release - extracted from workspace-hub configuration scripts

## Sub-Skills

- [1. Key=Value Configuration Parsing (+1)](1-keyvalue-configuration-parsing/SKILL.md)
- [3. JSON Report Generation](3-json-report-generation/SKILL.md)
- [4. Multi-Section INI Parsing](4-multi-section-ini-parsing/SKILL.md)
- [5. Environment Variable Configuration](5-environment-variable-configuration/SKILL.md)
- [6. YAML Configuration (via yq)](6-yaml-configuration-via-yq/SKILL.md)
- [1. Always Provide Defaults (+4)](1-always-provide-defaults/SKILL.md)

Recommended Agent Skills

Expand your agent's capabilities with these related and highly-rated skills.

vamseeachanta/workspace-hub

gsd-complete-milestone

Archive completed milestone and prepare for next version

4 4
Explore
vamseeachanta/workspace-hub

gsd-reapply-patches

Reapply local modifications after a GSD update

4 4
Explore
vamseeachanta/workspace-hub

gsd-verify-work

Validate built features through conversational UAT

4 4
Explore
vamseeachanta/workspace-hub

gsd-thread

Manage persistent context threads for cross-session work

4 4
Explore
vamseeachanta/workspace-hub

clinical-trial-protocol

Generate clinical trial protocols for medical devices or drugs through a modular, waypoint-based architecture with research-only and full protocol modes.

4 4
Explore
vamseeachanta/workspace-hub

single-cell-rna-qc

Performs quality control on single-cell RNA-seq data (.h5ad or .h5 files) using scverse best practices with MAD-based filtering and comprehensive visualizations.

4 4
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results