skillZs
★ LIVE SKILL TAGS ★
>>> LIVE SKILLS INDEX <<<
* OPEN SOURCE *
NO LOGIN, NO TRACKING
※ REAL INSTALL DATA ※
← back to all skills
impertio-studio/frappe_claude_skill_package125 installs

frappe-core-utils

Use when working with utility functions in Frappe v14-v16. Covers frappe.utils.* for date/time, number/money, string, validation, and file path operations. Prevents reinventing stdlib alternatives that break timezone awareness, locale formatting, or multi-tenancy. Keywords: frappe.utils, nowdate, flt, cint, fmt_money, getdate,, date calculation, format number, money format, validate email, how to calculate days between. add_days, date_diff, validate_email, pretty_date, get_files_path.

How do I install this agent skill?

npx skills add https://github.com/impertio-studio/frappe_claude_skill_package --skill frappe-core-utils
view source ↗

Is this agent skill safe to install?

  • Gen Agent Trust Hubpass

    This skill is a comprehensive reference guide for utility functions within the Frappe framework (v14-v16). It provides best practices for handling dates, currency, strings, and file paths, specifically encouraging the use of Frappe's built-in, timezone-aware, and multi-tenant-safe functions over standard Python libraries. No security issues or malicious patterns were identified.

  • Socketpass

    No alerts

  • Snykpass

    Risk: LOW · No issues

What does this agent skill do?

Frappe Utility Functions

Quick Reference: Python

NeedFunctionReturns
Current datenowdate() / today()datetime.date
Current datetimenow_datetime()datetime.datetime
Parse date stringgetdate(str)datetime.date
Parse datetime stringget_datetime(str)datetime.datetime
Add daysadd_days(date, n)datetime.date
Add monthsadd_months(date, n)datetime.date
Date differencedate_diff(end, start)int (days)
Format for userformat_date(dt)str (user locale)
Relative timepretty_date(dt)str ("2 hours ago")
Safe floatflt(val, precision)float
Safe intcint(val)int
Safe stringcstr(val)str
Safe boolsbool(val)bool
Safe divisionsafe_div(a, b)float [v15+]
Money formatfmt_money(amt, currency)str
Money in wordsmoney_in_words(amt, cur)str
Strip HTMLstrip_html(text)str
List to prosecomma_and(items)str ("a, b, and c")
Validate emailvalidate_email_address(e)str or ""
Validate URLvalidate_url(url)bool
Parse JSONparse_json(s)Any
Files pathget_files_path(is_private)str
Site pathget_site_path(*parts)str
Unique listunique(seq)list
Hashgenerate_hash(s, length)str

ALL imports: from frappe.utils import nowdate, flt, ... in controllers/whitelisted methods. In Server Scripts: Use frappe.utils.nowdate() directly — NO import statements allowed.


Decision Tree: "Which function do I use?"

Need a date/time value?
├─ Current date → nowdate() or today()
├─ Current datetime → now_datetime()
├─ Parse a string → getdate() or get_datetime()
├─ Add/subtract time → add_days(), add_months(), add_to_date()
├─ Difference → date_diff() (days), month_diff(), time_diff_in_seconds()
├─ Period boundary → get_first_day(), get_last_day(), get_quarter_start()
└─ Display to user → format_date(), format_datetime(), pretty_date()

Need a number?
├─ Convert safely → flt(), cint(), cstr(), sbool()
├─ Round → rounded() (banker's rounding)
├─ Safe divide → safe_div(a, b, default=0) [v15+]
├─ Format money → fmt_money(amount, currency)
└─ Money to words → money_in_words(amount, currency)

Need string processing?
├─ HTML → strip_html(), escape_html(), is_html()
├─ Join list → comma_and(), comma_or(), comma_sep()
├─ Markdown ↔ HTML → to_markdown(), md_to_html()
└─ Mask sensitive → mask_string(input, show_first=4) [v16+]

Need validation?
├─ Email → validate_email_address(email, throw=False)
├─ URL → validate_url(url, valid_schemes=["https"])
├─ Phone → validate_phone_number(phone, throw=False)
├─ JSON → validate_json_string(s)
└─ IBAN → validate_iban(iban) [v16+]

Need file/path?
├─ Public files → get_files_path()
├─ Private files → get_files_path(is_private=True)
├─ Site directory → get_site_path("private", "backups")
├─ Bench root → get_bench_path()
└─ File size → get_file_size(path, format=True)

Critical Anti-Patterns

NEVER use Python stdlib when frappe.utils exists

NEVER (stdlib)ALWAYS (frappe.utils)Why
datetime.datetime.now()now_datetime()Ignores system timezone
datetime.date.today()nowdate()Ignores system timezone
float(val)flt(val, precision)Crashes on None/empty
int(val)cint(val)Crashes on None/empty
round(val, 2)rounded(val, 2)Inconsistent rounding
val1 / val2safe_div(val1, val2)ZeroDivisionError [v15+]
json.loads(s)parse_json(s)Crashes on None/empty
json.dumps(obj)frappe.as_json(obj)Inconsistent serialization
"{:,.2f}".format(a)fmt_money(a, currency)Ignores locale/currency
os.path.join(...)get_site_path(...)Breaks multi-tenancy
", ".join(items)comma_and(items)No localized "and"
dt.strftime(fmt)format_date(dt)Ignores user preference
re.sub(r'<.*?>', '', h)strip_html(h)Misses edge cases

Server Script Sandbox

# ❌ NEVER in Server Scripts
from frappe.utils import nowdate, flt
import json

# ✅ ALWAYS in Server Scripts (no imports allowed)
today = frappe.utils.nowdate()
amount = frappe.utils.flt(doc.amount, 2)
data = frappe.parse_json(doc.json_field)

JavaScript Quick Reference

NeedFunction
Escape HTMLfrappe.utils.escape_html(txt)
HTML to textfrappe.utils.html2text(html)
Check if HTMLfrappe.utils.is_html(txt)
Parse JSONfrappe.utils.parse_json(str)
Validate URLfrappe.utils.is_url(txt)
Title casefrappe.utils.to_title_case(str)
Join with "and"frappe.utils.comma_and(list)
Unique arrayfrappe.utils.unique(list)
Copy clipboardfrappe.utils.copy_to_clipboard(txt)
Scroll to elementfrappe.utils.scroll_to(el)
Is mobilefrappe.utils.is_mobile()
Throttlefrappe.utils.throttle(fn, delay)
Debouncefrappe.utils.debounce(fn, delay)
Format valuefrappe.format(value, df, options, doc)
Duration displayfrappe.utils.get_formatted_duration(secs)

Version Differences

Functionv14v15v16
safe_div()--AddedYes
duration_to_seconds()--AddedYes
guess_date_format()--AddedYes
validate_duration_format()--AddedYes
mask_string()----Added
validate_iban()----Added
validate_name()----Added
safe_json_loads()----Added
groupby_metric()----Added
Core functionsYesYesYes

Reference Files

Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.

<a href="https://skillzs.dev/skills/impertio-studio/frappe_claude_skill_package/frappe-core-utils">View frappe-core-utils on skillZs</a>