fw-setup SKILL.md skillB

fw-setup from freshworks-developers/fw-dev-tools is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add freshworks-developers/fw-dev-tools/fw-setup@v1.3.0

Pins v1.3.0 in mdr.lock. Pin the fingerprint instead.

Audit grade
B, 16 of 17 checks passed
Kind
SKILL.md skill
Repository
freshworks-developers/fw-dev-tools
Path
skills/fw-setup/SKILL.md
Versions recorded
6
Latest version
v1.3.0, committed Sep 8, 2026
First version recorded
Jun 26, 2026
Size
25,883 bytes
Repository stars
6
License
MIT

Installs and manages Freshworks Development Kit (FDK) with Node.js via nvm for Platform 3.0 development. Supports FDK 10.x (Node 24, recommended) and FDK 9.x (Node 18, deprecated May 31, 2026). Slash commands: /fw-setup-install (--version), /fw-setup-upgrade (--to), /fw-setup-downgrade, /fw-setup-uninstall, /fw-setup-status (--verbose), /fw-setup-troubleshoot (--fix), /fw-setup-use (workspace nvm + .nvmrc). Legacy `/fdk-install` → use `/fw-setup-install`, etc. Publishing requires FDK 10.x +…

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

## Entry contract

- **Invoked by:** controller when toolchain missing or user requests FDK/Node setup
- **Preconditions:** User consent for mutating install/upgrade/downgrade operations
- **Returns:** `done` (fdk + node verified globally) | `blocked` (user declined install) | `escalate` (verification failed after retries)
- **On complete:** hand control back to the controller — controller resumes prior intent chain (e.g. fw-app-dev)
- **Session:** `session-read.sh` at start; on success — `session-write.sh <app-dir> progress.phase=setup` when app dir present

# FDK Setup

**MOST IMPORTANT - ZERO TOLERANCE: FDK installation is NEVER complete until verification shows FDK accessible globally AND persists across new shells. NEVER say "installation complete" with ANY verification failures.**
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add freshworks-developers/fw-dev-tools/fw-setup@sha256:415ddc472221d6fd

The line at the top of this page pins the label v1.3.0, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_qq7poxcrmnph4fs4.svg)](https://markdownregistry.com/a/art_qq7poxcrmnph4fs4)

3 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 6 versions of this file, between Jun 26, 2026 and Sep 8, 2026, about one every 15 days.

versioncommittedcommitsizeaudit
v1.3.0 latest2026-09-08 2672937 25,883 BB view · diff
v1.3.02026-09-06 633f7c5 25,313 BB view · diff
v1.3.02026-07-30 f07096f 25,007 BB view · diff
v1.2.02026-07-28 f55c5cd 25,007 BB view · diff
v1.2.02026-07-10 127e31e 24,520 BB view · diff
v1.2.02026-06-26 2f956cd 24,286 BB view

Audit of the latest version

B  16 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • fail: No recursive delete of root, home or parent (matched: rm -rf ~/)
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (25883 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Starting a new one? Use a template for SKILL.md on mdpantry, which passes every one of these checks and says what to change in it.

Source

GitHub

freshworks-developers/fw-dev-tools · 6 stars · license MIT · pushed 2026-09-23 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_qq7poxcrmnph4fs4
GET https://markdownregistry.com/api/v1/resolve?ref=freshworks-developers/fw-dev-tools/fw-setup
GET https://markdownregistry.com/api/v1/blob/415ddc472221d6fde6a912194ccddb9ba576dcd72d925ec8b9cedeba9cfe202d

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from freshworks-developers/fw-dev-tools

AGENTS.md AGENTS.md file
freshworks-developers/fw-dev-tools · AGENTS.md
git:20260908.1b24796 · audit A · 6 stars
CLAUDE.md CLAUDE.md file
freshworks-developers/fw-dev-tools · CLAUDE.md
git:20260710.127e31e · audit A · 6 stars
fw-ai-actions-app SKILL.md skill
freshworks-developers/fw-dev-tools · skills/fw-ai-actions-app/SKILL.md · Expert-level skill for AI Actions and integrations on Freshworks Platform 3.0. Use when (1) Creating actions.json and…
v1.3.0 · audit A · 6 stars
fw-app-dev SKILL.md skill
freshworks-developers/fw-dev-tools · skills/fw-app-dev/SKILL.md · Expert-level skill for building, debugging, reviewing, and migrating Freshworks Platform 3.0 marketplace apps. REQUIRES…
v1.3.0 · audit A · 6 stars
fw-publish SKILL.md skill
freshworks-developers/fw-dev-tools · skills/fw-publish/SKILL.md · Publish any Freshworks Platform 3.0 custom app via MCP tools: fdk validate/pack, app-upload, and submit/update through…
v1.3.0 · audit A · 6 stars
fw-review SKILL.md skill
freshworks-developers/fw-dev-tools · skills/fw-review/SKILL.md · Full Freshworks marketplace app review — iparams, frontend, serverless, FDK, security, and structured text report…
v1.3.0 · audit A · 6 stars

Every file in freshworks-developers/fw-dev-tools

Browse by kind, by grade B, or by owner.