create-feature-folder
Helper for creating timestamped feature directories. Use when creating new feature specs.
When & Why to Use This Skill
The Create Feature Folder skill is a specialized utility designed to automate the generation of standardized, timestamped directories for feature specifications. By automatically converting feature names to snake_case and prepending the current date (YYYYMMDD), it ensures a consistent and chronological project structure within the .molcajete/prd/specs/ path, eliminating manual naming errors and improving documentation organization.
Use Cases
- Standardizing feature specification storage: Automatically create consistently named directories for new PRDs or technical specs to maintain a clean project hierarchy.
- Chronological project tracking: Use the built-in timestamping logic to keep a clear, time-ordered history of feature development and requirements.
- Workflow automation for developers: Integrate the folder creation logic into larger automation scripts or CI/CD pipelines to streamline the initial setup of new project modules.
| name | create-feature-folder |
|---|---|
| description | Helper for creating timestamped feature directories. Use when creating new feature specs. |
Create Feature Folder Skill
When to Use
- Creating new feature directories in .molcajete/prd/specs/
- Need timestamped folder names (YYYYMMDD-feature_name format)
Usage
The timestamp logic is inlined directly in commands for portability:
FEATURE_DIR=$(python3 -c "from datetime import datetime; from pathlib import Path; import sys; name = sys.argv[1].replace('-', '_'); timestamp = datetime.now().strftime('%Y%m%d'); dir_name = f'{timestamp}-{name}'; Path(f'.molcajete/prd/specs/{dir_name}').mkdir(parents=True, exist_ok=True); print(dir_name)" "<feature-name>")
Output: Returns the timestamped directory name (e.g., 20251112-feature_name)
How it works:
- Converts feature name from kebab-case to snake_case
- Gets current date in YYYYMMDD format
- Creates directory name:
{timestamp}-{feature_name} - Creates directory at:
.molcajete/prd/specs/{timestamp}-{feature_name}/ - Returns just the directory name for use in subsequent commands
Example
# Create folder for "user-authentication" feature
FEATURE_DIR=$(python3 -c "from datetime import datetime; from pathlib import Path; import sys; name = sys.argv[1].replace('-', '_'); timestamp = datetime.now().strftime('%Y%m%d'); dir_name = f'{timestamp}-{name}'; Path(f'.molcajete/prd/specs/{dir_name}').mkdir(parents=True, exist_ok=True); print(dir_name)" "user-authentication")
# Creates: .molcajete/prd/specs/20251112-user_authentication/
# Returns: 20251112-user_authentication
# Use in subsequent commands
echo "Feature directory: ${FEATURE_DIR}"
# Output: Feature directory: 20251112-user_authentication