SKILL.md
Drupal Data Dictionary
Runs the bundled scripts/extractdatadictionary.py against a Drupal config export to produce five Excel workbooks documenting all field definitions.
Output files
Five .xlsx files are generated in the project root (directory containing the sync dir):
{prefix}-content-types.xlsx
{prefix}-taxonomy-vocabularies.xlsx
{prefix}-block-types.xlsx
{prefix}-media-types.xlsx
{prefix}-paragraph-types.xlsx
Workflow
- Gather configuration — before running, ask the user:
- Sync directory: path to the Drupal config export directory, relative to the project root (default: sync) - Output prefix: short identifier used to name the output files (suggest the project/site name, default: az-gov)
- Locate project root — confirm the sync directory exists at the path given. If the current working directory is not the project root, find it (check parent directories or ask the user).
- Check dependencies — verify Python packages are available:
``bash python3 -c "import openpyxl, yaml" ` If that fails, install them: `bash pip install openpyxl pyyaml ``
- Run the script from the project root:
``bash cd /path/to/project/root && python3 {skillbasedir}/scripts/extractdatadictionary.py \ --sync-dir {syncdir} \ --prefix {prefix} ` {skillbase_dir}` is the base directory shown at the top of this skill's context.
- Report the five generated
.xlsx files and their location.