Freecad
autonomous-ai/openharness
Turn measured design briefs or existing parts into editable FreeCAD projects with checked dimensions, bores, clearances, interference and fastener access; deliver separate STEP/STL parts, reference…
Create an involute spur gear using FreeCAD's Part module. An agent skill from ghbalf/freecad-ai.
$ npx skills add ghbalf/freecad-ai --skill gear -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install ghbalf/freecad-ai gear --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/ghbalf/freecad-ai.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/gear .claude/skills/gear && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "gear" agent skill from https://github.com/ghbalf/freecad-ai/tree/master/skills/gear into .claude/skills/gear/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "gear", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/ghbalf/freecad-ai/tree/master/skills/gearType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add ghbalf/freecad-ai --skill gear -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install ghbalf/freecad-ai gear --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/ghbalf/freecad-ai.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/gear .agents/skills/gear && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "gear" agent skill from https://github.com/ghbalf/freecad-ai/tree/master/skills/gear into .agents/skills/gear/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "gear", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add ghbalf/freecad-ai --skill gear -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install ghbalf/freecad-ai gear --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/ghbalf/freecad-ai.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/gear .cursor/skills/gear && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "gear" agent skill from https://github.com/ghbalf/freecad-ai/tree/master/skills/gear into .cursor/skills/gear/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "gear", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/ghbalf/freecad-ai.git --path skills/gear--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add ghbalf/freecad-ai --skill gear -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install ghbalf/freecad-ai gear --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/ghbalf/freecad-ai.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/gear .gemini/skills/gear && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "gear" agent skill from https://github.com/ghbalf/freecad-ai/tree/master/skills/gear into .gemini/skills/gear/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "gear", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install ghbalf/freecad-ai gearInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add ghbalf/freecad-ai --skill gear -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/ghbalf/freecad-ai.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/gear .github/skills/gear && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "gear" agent skill from https://github.com/ghbalf/freecad-ai/tree/master/skills/gear into .github/skills/gear/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "gear", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add ghbalf/freecad-ai --skill gear -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install ghbalf/freecad-ai gear --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/ghbalf/freecad-ai.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/gear .opencode/skills/gear && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "gear" agent skill from https://github.com/ghbalf/freecad-ai/tree/master/skills/gear into .opencode/skills/gear/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "gear", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
gearCreate an involute spur gear using FreeCAD's Part module. An agent skill from ghbalf/freecad-ai.
Gear is an agent skill from ghbalf/freecad-ai. Create an involute spur gear using FreeCAD's Part module.
Its SKILL.md is about 1.2k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.
The repository describes itself as: AI-powered assistant workbench for FreeCAD — generate 3D models from natural language.
Read from SKILL.md and the folder at commit 5ef1e2d. It shows what the files ask for, not the result of running them.
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
No scripts in the folder and no shell commands in SKILL.md (its code samples are python).
From the folder's file list and the shell code blocks in SKILL.md.
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Gear loads about 1.2k tokens when it runs. Until then it costs about 16 tokens; SKILL.md has 150 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.
The full file from ghbalf/freecad-ai at commit 5ef1e2d, republished under its LGPL-2.1 licence (© ghbalf). 150 words, ~1,242 tokens.
.claude/skills/gear/SKILL.md (or your agent's skills folder).Create an involute spur gear using FreeCAD's Part module.
Use execute_code with the complete gear generation code below.
Replace the parameter values at the top with the user's requested values.
import math
import Part
import FreeCAD as App
# === PARAMETERS (replace with user values) ===
module = 2.0
teeth = 20
pressure_angle_deg = 20
face_width = 10.0
bore_dia = 5.0
# === DERIVED ===
pitch_r = module * teeth / 2.0
base_r = pitch_r * math.cos(math.radians(pressure_angle_deg))
tip_r = pitch_r + module
root_r = pitch_r - 1.25 * module
def involute_pts(base_r, tip_r, n=20):
max_angle = math.sqrt((tip_r / base_r) ** 2 - 1)
pts = []
for i in range(n):
t = i * max_angle / (n - 1)
x = base_r * (math.cos(t) + t * math.sin(t))
y = base_r * (math.sin(t) - t * math.cos(t))
pts.append(App.Vector(x, y, 0))
return pts
def rotate_pt(pt, angle_rad):
c, s = math.cos(angle_rad), math.sin(angle_rad)
return App.Vector(c * pt.x - s * pt.y, s * pt.x + c * pt.y, 0)
def pt_angle(pt):
return math.atan2(pt.y, pt.x)
# Involute half-tooth thickness angle
inv_alpha = math.tan(math.radians(pressure_angle_deg)) - math.radians(pressure_angle_deg)
half_thick_angle = math.pi / (2 * teeth) + inv_alpha
# Generate involute profile for one tooth, centered on +Y axis
right_involute = involute_pts(base_r, tip_r, 20)
right_side = [rotate_pt(p, -half_thick_angle + math.pi / 2) for p in right_involute]
left_side = [App.Vector(-p.x, p.y, 0) for p in right_side]
# Key points
left_base, left_tip = left_side[0], left_side[-1]
right_base, right_tip = right_side[0], right_side[-1]
lb_a, rb_a = pt_angle(left_base), pt_angle(right_base)
# Points on root circle at flank angles
lb_on_root = App.Vector(root_r * math.cos(lb_a), root_r * math.sin(lb_a), 0)
rb_on_root = App.Vector(root_r * math.cos(rb_a), root_r * math.sin(rb_a), 0)
# Build closed tooth profile: root → left involute → tip arc → right involute → root arc
tooth_edges = []
# Radial: left root → left base
if lb_on_root.distanceToPoint(left_base) > 0.01:
tooth_edges.append(Part.LineSegment(lb_on_root, left_base).toShape())
# Left involute BSpline (base → tip)
bs_left = Part.BSplineCurve()
bs_left.interpolate(left_side)
tooth_edges.append(bs_left.toShape())
# Tip arc (left tip → right tip)
tip_mid_a = (pt_angle(left_tip) + pt_angle(right_tip)) / 2
tip_mid = App.Vector(tip_r * math.cos(tip_mid_a), tip_r * math.sin(tip_mid_a), 0)
tooth_edges.append(Part.Arc(left_tip, tip_mid, right_tip).toShape())
# Right involute BSpline (tip → base)
bs_right = Part.BSplineCurve()
bs_right.interpolate(list(reversed(right_side)))
tooth_edges.append(bs_right.toShape())
# Radial: right base → right root
if right_base.distanceToPoint(rb_on_root) > 0.01:
tooth_edges.append(Part.LineSegment(right_base, rb_on_root).toShape())
# Root arc (right root → left root, closing the profile)
root_mid_a = (lb_a + rb_a) / 2
root_mid = App.Vector(root_r * math.cos(root_mid_a), root_r * math.sin(root_mid_a), 0)
tooth_edges.append(Part.Arc(rb_on_root, root_mid, lb_on_root).toShape())
# Create one tooth solid
tooth_wire = Part.Wire(tooth_edges)
tooth_face = Part.Face(tooth_wire)
tooth_solid = tooth_face.extrude(App.Vector(0, 0, face_width))
# Build gear: base cylinder + all teeth fused together
gear = Part.makeCylinder(root_r, face_width)
for t in range(teeth):
rotated = tooth_solid.copy()
if t > 0:
rotated.rotate(App.Vector(0, 0, 0), App.Vector(0, 0, 1), t * 360.0 / teeth)
gear = gear.fuse(rotated)
gear = gear.removeSplitter()
# Cut bore hole
if bore_dia > 0:
bore = Part.makeCylinder(bore_dia / 2, face_width + 2, App.Vector(0, 0, -1))
gear = gear.cut(bore)
# Add to document
gear_obj = App.ActiveDocument.addObject("Part::Feature", "Gear_M{}_Z{}".format(module, teeth))
gear_obj.Label = "Gear M{} Z{}".format(module, teeth)
gear_obj.Shape = gear
App.ActiveDocument.recompute()
print("Gear created: pitch dia={:.1f}mm, tip dia={:.1f}mm, root dia={:.1f}mm".format(
pitch_r * 2, tip_r * 2, root_r * 2))execute_code, only changing the parameter values at the topApp.Gui — it may not be available in the sandbox© ghbalf, LGPL-2.1. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Just SKILL.md in skills/gear of ghbalf/freecad-ai.
Open the folder on GitHubat commit 5ef1e2d
Gear next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Gear this skillghbalf/freecad-ai | 550 | — | ~1.2k | Automated safety check: Pass | LGPL-2.1 | |
| Freecadautonomous-ai/openharness | 1.1k | — | ~1.4k | Automated safety check: Pass | MIT | |
| Es Modulesthedaviddias/Front-End-Checklist | 74k | — | ~482 | Automated safety check: Pass | MIT | |
| Freecad Scriptsgithub/awesome-copilot | 40k | 1 repos | ~5.3k | Automated safety check: Pass | MIT | |
| Step Partsearthtojake/text-to-cad | 18k | 1 repos | ~1.5k | Automated safety check: Pass | MIT | |
| Splitting Oversized ModulesPostHog/posthog | 40k | — | ~2.2k | Automated safety check: Pass | Custom licence |
autonomous-ai/openharness
Turn measured design briefs or existing parts into editable FreeCAD projects with checked dimensions, bores, clearances, interference and fastener access; deliver separate STEP/STL parts, reference…
thedaviddias/Front-End-Checklist
A skill your agent uses when reviewing scripts, client components, bundles, or runtime behavior related to Use ES modules (import/export).
github/awesome-copilot
Expert skill for writing FreeCAD Python scripts, macros, and automation.
earthtojake/text-to-cad
Find, evaluate, and download common purchasable CAD parts from step.parts, including named off-the-shelf actuators, servos, motors, electronics boards, connectors, screws, bolts, nuts, washers…
PostHog/posthog
Split an oversized Python module (a thousand-plus-line logic.py, models.py, api.py, or its test file) into a package of one module per concern, mechanically and provably without changing behavior.
abpframework/abp
ABP reusable Module solution template - EF Core + MongoDB dual support, virtual methods for extensibility, DbTablePrefix, module options pattern, entity extension, separate connection string.
ghbalf/freecad-ai
Create new FreeCAD AI skills, modify existing skills, and iteratively improve them.
ghbalf/freecad-ai
Generate a draft VALIDATION.md for a skill by analyzing its SKILL.md construction steps
ghbalf/freecad-ai
Generate a parametric electronics enclosure with a base and lid.
ghbalf/freecad-ai
Create standard fastener holes: clearance, counterbore, or countersink.
ghbalf/freecad-ai
Generate a 3D lattice or infill pattern inside a bounding region.
ghbalf/freecad-ai
Extract 2D geometry from an attached image and create a FreeCAD sketch from it.
Create an involute spur gear using FreeCAD's Part module. An agent skill from ghbalf/freecad-ai. Gear is an agent skill from ghbalf/freecad-ai. Create an involute spur gear using FreeCAD's Part module.
Run `npx skills add ghbalf/freecad-ai --skill gear -a claude-code`. Or copy the skill folder (skills/gear in ghbalf/freecad-ai) into .claude/skills/gear in your project. Claude Code loads it when a task matches its description.
Run `npx skills add ghbalf/freecad-ai --skill gear -a codex`. Or copy the skill folder (skills/gear in ghbalf/freecad-ai) into .agents/skills/gear in your project. Codex loads it when a task matches its description.
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add ghbalf/freecad-ai --skill gear -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/gear, .gemini/skills/gear, .github/skills/gear and .opencode/skills/gear in your project.
SKILL.md names no scripts, command-line tools or credentials: Gear is instructions for the agent only. Our summary lists: Python 3.
SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.
Gear is published under the LGPL-2.1 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
About 1.2k tokens (SKILL.md is roughly 5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.
Skills that share tags, products or a category with Gear: Freecad (autonomous-ai/openharness, 1.1k stars), Es Modules (thedaviddias/Front-End-Checklist, 74k stars), Freecad Scripts (github/awesome-copilot, 40k stars) and Step Parts (earthtojake/text-to-cad, 18k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
ghbalf (a GitHub user) maintains it in ghbalf/freecad-ai, which has 550 GitHub stars. The repository holds 9 skills in this directory. The repository was last updated on October 3, 2026.
Source: ghbalf/freecad-ai on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.