javascript-development

Standardize JavaScript practices for Metalsmith plugins and Node build pipelines.

Updated Jan 13, 2026
One-click install
npx skills add https://github.com/wernerglinka/metalsmith-website-skills --skill javascript-development
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: javascript-development
Source: https://github.com/wernerglinka/metalsmith-website-skills/tree/main/javascript-development
Command: npx skills add https://github.com/wernerglinka/metalsmith-website-skills --skill javascript-development

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill provides a structured, consensus-driven approach to JavaScript development across Metalsmith plugins, browser scripts, and Node.js tooling, addressing inconsistencies that slow projects and complicate maintenance.

Core Features & Use Cases

  • Functional-first patterns: Promote pure functions, immutability, and clear data flow to reduce bugs.
  • ES6+ best practices: Guidance on modern syntax (const/let, destructuring, template literals, async/await).
  • Documentation discipline: Use JSDoc for type hints and API clarity, with dual ESM/CJS module support for broad compatibility.
  • Testing and tooling: Mocha-based testing patterns and a scalable project structure for plugin development, browser scripts, and Node build tasks.
  • Use Case: Build a Metalsmith plugin that processes files with pure transformations, and test it with Mocha to ensure predictable results.

Quick Start

Install Node.js, initialize a Metalsmith project, and apply the described patterns to implement a simple plugin with unit tests.

Frequently Asked Questions about javascript-development

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

FAQPage Schema
What are the best JavaScript patterns for building Metalsmith plugins?

The best JavaScript patterns for Metalsmith plugins involve functional-first design using pure functions, immutability, and explicit data flow. This approach enforces ES6+ syntax and JSDoc for type hints, reducing bugs and simplifying maintenance across Node.js build pipelines.

How do I document JavaScript code without TypeScript in Node.js build tooling?

You document JavaScript code without TypeScript by using JSDoc for type hints and API clarity. This approach provides strict typing and documentation discipline for Node.js build tooling while maintaining dual ESM and CJS module support for broad compatibility.

Does this JavaScript development approach require TypeScript?

No, this JavaScript development approach does not require TypeScript. It relies entirely on JSDoc for type hints and API clarity, applying functional patterns and ES6+ best practices to ensure reliable, maintainable code without the overhead of a typed language.

How do I test Metalsmith plugins for predictable file transformations?

You test Metalsmith plugins using Mocha-based testing patterns to ensure predictable file transformations. By building plugins with pure functions and immutability, you can verify that data flow remains explicit and unit tests produce consistent, reliable results.

Why should I use functional programming patterns in Node.js build pipelines?

You should use functional programming patterns in Node.js build pipelines to promote pure functions and immutability, which reduce bugs. This structured approach enforces explicit data flow and modern ES6+ syntax, resulting in highly maintainable and reliable build tooling.