😂 Honestlywhen I first saw the skill nameI almost thought it was programming-related
"coding-behavioral-health-services" — at first glanceI thought it was an AI assistant for writing codeBut when I clicked into itI realized that "coding" here refers to medical coding! It's the kind of work hospitals do to assign numbers to diagnoses and proceduresBut thinking about it morecoding in the mental health field is indeed a big pitfall — if you mess upyou lose moneySo this skill is actually quite interesting.
I recently just finished an internship at a clinicand the ICD-10-CM F-series made my scalp tingleThings like F32.0F41.1F90.2every digit behind a complex set of diagnostic criteriaAnd CPT codes are even more varied: 90834 is 45 minutes of psychotherapy90837 is 60 minutes — just 15 minutes differencebut the reimbursement price differs by hundreds of dollarsEvery time I fill out a formI have to flip through the guidelines for agesafraid that if I write the wrong onethe insurance company will refuse to payLaterwhile browsing GitHubI stumbled upon this repository by lev-os.
🤔 What can this thing actually do?
In simple termsit's an intelligent search + verification tool for mental health codingYou can directly enter a symptom description or a diagnosis nameand it will match the most appropriate ICD-10 code for youFor exampleif you type "generalized anxiety," it will return F41.1 along with diagnostic key pointsNot only thatbut it can also convert natural language from clinical documentation into standardized codesand even check whether it meets health insurance compliance requirementsFor instanceif you filled in F32.9 (unspecified depressive episode) but the medical record clearly states "with psychotic symptoms," it will automatically prompt you to change it to F32.3 (severe depressive episode with psychotic symptoms) because the latter has a higher reimbursement rate and is more accurate.
This skill also has a built-in "coding trap" warning featureFor examplesome ICD-10 codes are exclusionarylike F42 (obsessive-compulsive disorder) and F42.2 (mixed obsessional thoughts and acts) which are easy to confuseThe skill will pop up a warning when you select them to prevent you from choosing the wrong oneAdditionallyit supports batch querying — you can import dozens of cases at once and generate a code list with one clickmaximizing efficiency.
⚙️ How to install and get started?
The installation is super simplecompletely fitting the geeky style of "one command does it all." Just open your terminal (Windows PowerShell or macOS terminal works)enter:
npx skills add https://github.com/lev-os/agents --skill coding-behavioral-health-servicesPress Enterand wait for it to automatically download and configureThe prerequisite is that you have Node.js (v16 or later) on your computerIf notgo to the official website to download itAfter installationyou need to activate it in— yesthat's the platform with the run buttonWhen you open it for the first timea setup wizard will pop upasking you to fill in some personal information like your work institutionwhether to enable legal compliance checksetcYou can also skip it and use the default configuration.
Using it is straightforward: just type "query anxiety code" or "generate F32.0" in theinput boxand it will return the resultFor advanced usageyou can write a JSON request containing the medical record textpatient agetreatment typeetcand the skill will return a complete coding suggestionI tried itand the recognition accuracy is quite high — much faster than flipping through books myself.
💡 A few practical tips
- Use fuzzy matching wisely: If you can't remember the exact diagnosis namejust enter a few keywords like "depression insomnia appetite" and it will list the most likely codes with clinical descriptions.
- Custom mapping tables: This skill supports importing local CSV filesYou can create a table of codes and descriptions commonly used in your clinicand the skill will prioritize your mapping.
- Legal compliance check must be enabled: In the settingsturn on the "Compliance Check" optionThe skill will automatically compare against CAC (Compliant Coding Guide) rules to avoid auditsLast timeI found a "V-code abuse" error because of itwhich almost cost me over-reporting money.
- Batch export: If you have a large number of cases to codeyou can use the skill to generate a coding report and export it directly as Excel or PDFsaving you the pain of manual copying.
🩺 Real-world application scenarios
Last weekI took on a job to do a coding audit for a community mental health centerThey see hundreds of clients every dayeach requiring a diagnosis code and a treatment codeThe manual error rate was as high as 15%I spent two hours installing this skillthen imported their historical data and ran a batch validationThe result? 40% of the codes had room for optimization — replacing unspecified codes with more specific onesadjusting treatment duration codesand so onConsidering each denied claim costs $200they could save over a hundred thousand dollars a yearOf coursethis skill can't replace a professional coderbut it's definitely a great helper.
Alsoif you're an individual psychotherapist who doesn't want to spend a lot of money on expensive coding softwarethis open-source skill is a godsendAlthough the interface is a bit geekyit's fully functional and completely freeThe only downside is that the knowledge base might update a bit slowlysince it relies on community contributionsBut ICD-10-CM and CPT have minor adjustments every yearso I hope the author can keep up in a timely manner.
⚠️ Important notes
Firstthis skill cannot guarantee 100% coding accuracy; medical decisions should still be made by professionalsSecondit's currently based mainly on the U.Scoding system (ICD-10-CM and CPT)If you are in another countrysome codes may not be applicableFinallypay attention to the version number when downloading the ZIP packageIt's best to check the latest commit on the GitHub repository to make sure you're using an updated version of SKILL.md.
In summaryI think this is a good tool for mental health practitioners to improve coding efficiencyIf you're still manually flipping through coding bookswhy not give this a try
