chef-custom-resources

Migrate Chef Infra cookbooks to modern custom resources with unified_mode.

2|Updated Feb 5, 2026
One-click install
npx skills add https://github.com/damacus/agent-skills --skill chef-custom-resources
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: chef-custom-resources
Source: https://github.com/damacus/agent-skills/tree/main/skills/chef-custom-resources
Command: npx skills add https://github.com/damacus/agent-skills --skill chef-custom-resources

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps teams migrate Chef Infra cookbooks from legacy patterns to modern, self-contained custom resources, reducing complexity and increasing maintainability.

Core Features & Use Cases

  • Provides modern resource patterns with unified_mode and explicit provides for each resource
  • Implements a phase-driven migration workflow (Phase 0 through Phase 7) to guide structure, tests, and verification
  • Enforces best practices such as removing recipes/attributes directories in full migrations and leveraging partials and helper modules

Quick Start

Start by confirming scope with the user and then execute Phase 1 through Phase 7 to complete the modernization.

Frequently Asked Questions about chef-custom-resources

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

FAQPage Schema
How do I migrate Chef Infra cookbooks to custom resources?

Migrate Chef Infra cookbooks by following a phase-driven workflow from Phase 0 through Phase 7 that guides structure, tests, and verification across platforms. This modernization process replaces legacy libraries with flat, testable resources.

What is unified_mode in Chef custom resources?

Unified_mode is a modern Chef Infra resource pattern enforced during migration to ensure custom resources execute properties and actions in a unified compile-and-execute phase. It is required for all modernized resources in this workflow.

Does Chef cookbook migration remove legacy recipes and attributes directories?

Yes, full migrations enforce best practices by removing recipes and attributes directories entirely. The workflow replaces legacy patterns with self-contained custom resources, leveraging partials and helper modules to reduce complexity and increase maintainability.

How do I test Chef custom resources with ChefSpec and InSpec?

Testing custom resources with ChefSpec and InSpec is integrated into the phase-driven migration workflow. The phases explicitly guide structure, testing, and verification across platforms to ensure modernized resources are fully testable.

What are the limitations of migrating Chef cookbooks to modern custom resources?

The migration workflow ensures no unsupported directories are modified during the process. It targets teams replacing legacy libraries with flat resources, requiring explicit provides declarations for each resource and strict adherence to the phase-driven structure.