dalec-spec-generator

Generate deterministic Dalec specification YAML files from GitHub repositories.

Updated Dec 30, 2025
One-click install
npx skills add https://github.com/Ryuki-997/dalec-mapping --skill dalec-spec-generator
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: dalec-spec-generator
Source: https://github.com/Ryuki-997/dalec-mapping/tree/main/skills/dalec-spec-generator
Command: npx skills add https://github.com/Ryuki-997/dalec-mapping --skill dalec-spec-generator

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Automates the end-to-end creation of Dalec specification files from GitHub repositories by providing a reproducible, deterministic workflow that converts repo contents into validated Dalec YAML specs.

Core Features & Use Cases

  • Deterministic discovery of build files (Dockerfile and Makefile) across a repository, with a fresh result directory for each run.
  • Automated extraction of non-deterministic values and generation of a complete Dalec spec via a CLI, enabling repeatable builds for container and package workflows.
  • Suitable for monorepos and multi-path repositories where build files live in subdirectories, with outputs organized under result/{repo}/.
  • Use Case: A developer wants to convert a GitHub project into a published Dalec spec to enable automated container builds and packaging.

Quick Start

Run the three-step workflow: discover build files, download them, then generate the Dalec spec YAML.

Frequently Asked Questions about dalec-spec-generator

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate Dalec specs from a GitHub repository automatically?

To generate Dalec specs automatically, this Skill discovers Dockerfile and Makefile build configurations in a GitHub repository, extracts non-deterministic values, and outputs a validated Dalec YAML file for container builds.

What is a deterministic Dalec specification file used for?

A deterministic Dalec specification file provides a reproducible YAML configuration that defines how a software project's Dockerfile and Makefile-based build should be executed for container builds and packaging workflows.

Can I generate Dalec specs for monorepos where build files are in subdirectories?

Yes, you can generate Dalec specs for monorepos. The workflow deterministically discovers build files across multiple repository paths and organizes the resulting YAML outputs under dedicated repository-specific result directories.

How do I convert a Dockerfile and Makefile project into a container build configuration?

Converting a Dockerfile and Makefile project requires discovering the build files, downloading repository contents, and executing a CLI that extracts non-deterministic values to produce a complete Dalec spec YAML configuration.

What are the limitations of generating Dalec specs from GitHub repositories?

The main limitation is that Dalec spec generation primarily targets software projects using Dockerfile and Makefile-based build configurations, meaning repositories relying on other build systems may not be fully supported.

Why does my generated Dalec YAML spec need to extract non-deterministic values?

Extracting non-deterministic values is required to produce a deterministic Dalec YAML spec, ensuring that your container builds remain reproducible and repeatable across different automated build environments.