EVS Data Tools

The evs-data-tools plugin installs a set of skills for working with Earth Volumetric Studio (EVS) data. Together they teach AI agents to create, read, validate and convert EVS data files. Ask your agent to turn a spreadsheet of borehole data into an EVS file, convert a file from one EVS format to another, or check a file before you load it in EVS.

The evs-data skill

The evs-data skill is the top-level reference for EVS data. It helps your AI agent understand the EVS file formats and the requirements for EVS data, such as units, elevation or depth, and how to handle missing or ambiguous values. Use it whenever you work with EVS data files. It routes the agent to the skill for each file type or conversion, which loads only when it is needed.

For example prompts and the questions your agent asks before it writes a file, see Using the Skills.

The skills follow the open Agent Skills format, so they work in Claude Code, Claude Desktop and claude.ai, Codex, Microsoft 365 Copilot and many other agents. See Install.

File formats

FormatSkillContents
.apdvevs-apdvAnalyte Point Data File. Analyte concentrations at points in borings
.aidvevs-aidvAnalyte Interval Data File. Analyte concentrations over depth intervals
.lpdvevs-lpdvLithology Point Data File. Lithology at points in borings
.lsdvevs-lsdvLithology Screen Data File. Lithology over screen intervals
.pgfevs-pgfPreGeology File. Lithology transitions down each boring
.geoevs-geoBorehole Geologic Stratigraphy File
.gmfevs-gmfGeologic Stratigraphy Multi-File. Each surface defined by its own points

Conversions

The evs-convert skill converts between EVS data formats, for example PGF to LSDV, LSDV to LPDV, GEO to GMF and APDV to AIDV, and the reverse. It also builds a geologic hierarchy to turn lithology (PGF or LSDV) into stratigraphy (GEO or GMF). The agent tells you when a conversion loses data or needs your interpretation, and checks the result afterwards.

Skills in the plugin

SkillFile TypeDescription
evs-data—Top-level reference. Shared rules, concepts and routing table
evs-lithology—Shared lithology concepts. Materials, ID ordering, simplification
evs-convert—Conversion procedures between EVS data file formats
evs-apdv.apdvAnalyte Point Data File
evs-aidv.aidvAnalyte Interval Data File
evs-lpdv.lpdvLithology Point Data File
evs-lsdv.lsdvLithology Screen Data File
evs-pgf.pgfPreGeology File
evs-geo.geoBorehole Geologic Stratigraphy File
evs-gmf.gmfGeologic Stratigraphy Multi-File

When installed as a plugin the skills are namespaced, for example /evs-data-tools:evs-data. For the best results, start each session by calling evs-data by name. See Using the Skills.

Who is licensed

The skills are licensed only to C Tech customers with a current, paid EVS Fixed, Floating, Enterprise or University Enterprise subscription, under the C Tech AI Integrations License Agreement. The files are public so they are easy to install, but public availability does not grant a license.

  • Install

    Install EVS Data Tools in your AI agent, for yourself or for your organization

  • Updates

    How each platform updates EVS Data Tools, and how to update by hand

  • Using the Skills

    Example prompts, and the questions your agent asks before it writes a file

  • Moving from the AI Skills Installer

    Replace skills installed by the earlier C Tech EVS AI Skills installer

Subsections of EVS Data Tools

EVS Data Tools is published in the public CTechCorp/ai-plugins repository on GitHub. Each agent platform installs it from there in its own way. Choose your platform below.

PlatformPage
Claude CodeClaude Code
Claude Desktop and claude.aiClaude Desktop and claude.ai
Codex in the ChatGPT application, Codex command lineChatGPT and Codex
Cursor, GitHub Copilot, Gemini CLI and other agentsOther Agents (npx skills)
Microsoft 365 Copilot and Copilot StudioMicrosoft 365 Copilot
A whole team or organizationOrganization-Wide

If you installed the skills with the earlier C Tech EVS AI Skills installer, uninstall it first. See Moving from the AI Skills Installer.

Subsections of Install

In Claude Code the skills install as the evs-data-tools plugin from the ctech marketplace. Run both commands in a terminal.

License

Licensed only to C Tech customers with a current EVS subscription. By installing, you agree to the C Tech AI Integrations License Agreement included with the release, also published at https://ctech.com/downloads/.

Add the C Tech marketplace.

claude plugin marketplace add CTechCorp/ai-plugins

Install the plugin.

claude plugin install evs-data-tools@ctech
Already installed in Claude Desktop?

Claude Code and Claude Desktop on the same computer share plugins. If you installed EVS Data Tools in Claude Desktop, it is already installed in Claude Code, so skip both commands. To check, run this command and look for evs-data-tools@ctech.

claude plugin list

If you run the first command anyway, it fails with this message, which only means the marketplace is already added.

Cannot add marketplace "ctech": its network source differs from the one declared for it in settings

For the best results, start each session by calling /evs-data-tools:evs-data with what you plan to do. See Using the Skills.

To make the plugin available to everyone who works in a project, see Organization-Wide. Claude Code does not update the plugin automatically unless you turn that on. See Updates.

In Claude Desktop and claude.ai, you add the C Tech marketplace and then the EVS Data Tools plugin from the Customize menu.

License

Licensed only to C Tech customers with a current EVS subscription. By installing, you agree to the C Tech AI Integrations License Agreement included with the release, also published at https://ctech.com/downloads/.

  1. Open Customize > Plugins > Add > Add marketplace.
  2. Enter CTechCorp/ai-plugins.
  3. Back in Plugins, choose Skills, search for evs and choose Add next to EVS Data Tools.

EVS Data Tools then appears under Your plugins.

Already installed in Claude Code?

Claude Desktop and Claude Code on the same computer share plugins. If you installed EVS Data Tools with Claude Code, it is already listed under Your plugins as Installed locally, so skip these steps. This does not apply to claude.ai in a web browser, where plugins belong to your account rather than your computer.

Team and Enterprise owners can provision the plugin for the whole organization instead. See Organization-Wide.

The marketplace does not update automatically unless you turn on Sync automatically. See Updates.

In Codex the skills install as the EVS Data Tools plugin (evs-data-tools) from the C Tech marketplace (ctech). Use Codex in the ChatGPT application or the Codex command line.

License

Licensed only to C Tech customers with a current EVS subscription. By installing, you agree to the C Tech AI Integrations License Agreement included with the release, also published at https://ctech.com/downloads/.

Codex in the ChatGPT application

  1. In the ChatGPT application, open Codex, then open Customize from the sidebar and choose Plugins.
  2. Choose Add, then Add a marketplace, and enter CTechCorp/ai-plugins.
  3. Search the plugins for EVS.
  4. Choose + next to EVS Data Tools. It shows Installing and then appears under Installed.

Codex command line

Add the C Tech marketplace.

codex plugin marketplace add CTechCorp/ai-plugins

Install the plugin.

codex plugin add evs-data-tools@ctech

To update later, see Updates.

Agents that read the open Agent Skills format, such as Cursor, GitHub Copilot and Gemini CLI, can install the skills with the npx skills command. It needs Node.js, which provides npx.

License

Licensed only to C Tech customers with a current EVS subscription. By installing, you agree to the C Tech AI Integrations License Agreement included with the release, also published at https://ctech.com/downloads/.

npx skills add CTechCorp/ai-plugins

npx skills does not update the skills automatically. See Updates.

Microsoft 365 Copilot and Copilot Studio allow at most 8 skills per agent and 20,000 characters per SKILL.md. To fit, each release includes evs-data-<version>.zip, a single skill with the format specs in references/ and the license in LICENSE.md.

Step 1. Download the skill

License

Licensed only to C Tech customers with a current EVS subscription. By installing, you agree to the C Tech AI Integrations License Agreement included with the release, also published at https://ctech.com/downloads/.

Open the latest release of CTechCorp/ai-plugins. Under Downloads at the top of the release notes, choose the Microsoft 365 Copilot and Copilot Studio link, evs-data-<version>.zip. You do not need the plugin archive (evs-data-tools-<version>.zip) or the Source code archives.

Step 2. Upload it

  • Microsoft 365 Copilot. Upload the zip in Agent Builder, for a declarative agent.
  • Copilot Studio. Upload the zip from Build > Skills > Upload a skill.

These platforms do not update the skill automatically. To update, upload the zip from the new release. See Updates.

You can make the plugin available to everyone in a project or an organization, instead of having each person install it.

License

Licensed only to C Tech customers with a current EVS subscription. By installing, you agree to the C Tech AI Integrations License Agreement included with the release, also published at https://ctech.com/downloads/.

The person who commits the plugin to a project’s settings, or provisions it for the organization, accepts the license for the organization.

Claude Code, for everyone in a project

Commit this to the project’s .claude/settings.json. Everyone who opens the project in Claude Code gets the C Tech marketplace and the evs-data-tools plugin.

{
  "extraKnownMarketplaces": {
    "ctech": { "source": { "source": "github", "repo": "CTechCorp/ai-plugins" } }
  },
  "enabledPlugins": { "evs-data-tools@ctech": true }
}

Claude Team and Enterprise, for the whole organization

Team and Enterprise owners can provision the plugin for the whole organization in Claude Desktop and claude.ai.

  1. Open Organization settings > Plugins & skills.
  2. Add the marketplace CTechCorp/ai-plugins.

The owner who provisions the plugin also decides how it updates, with Sync automatically on the marketplace. See Updates.

C Tech publishes new releases of EVS Data Tools in CTechCorp/ai-plugins. You choose when to update.

Update by platform

License

Licensed only to C Tech customers with a current EVS subscription. By installing, you agree to the C Tech AI Integrations License Agreement included with the release, also published at https://ctech.com/downloads/.

PlatformAutomatic updatesTurn on or offUpdate by hand
Claude CodeOff by default for this marketplace/plugin > Marketplaces > ctech > Enable or Disable auto-updateclaude plugin update evs-data-tools@ctech
Claude Desktop and claude.aiOff unless you turn on Sync automaticallySync automatically on the ctech marketplaceCheck for updates
Organization-wide (Team and Enterprise)Set by the owner who provisions itSync automatically on the marketplace, in Organization settings > Plugins & skillsCheck for updates
CodexNot documented—codex plugin marketplace upgrade ctech, then start a new session
npx skillsNo—npx skills check, then npx skills update
Microsoft 365 Copilot and Copilot StudioNo—Upload the new evs-data-<version>.zip. In Copilot Studio, use the skill’s … menu > Replace

In Claude Code, claude plugin marketplace update ctech refreshes the list of versions but does not update the installed plugin.

Each release carries its own license version in LICENSE.md, and the release notes say when it changes. See License.

Start with the evs-data skill

For the best results, call the evs-data skill by name once, at the start of the session, together with what you plan to do.

/evs-data-tools:evs-data We will be creating EVS data files from this folder.

This works far better in most agents, including Claude Desktop and Codex, than waiting for the skills to load on their own. Once evs-data is loaded, it brings in the skill for each file type or conversion as the work needs it. After that, describe each task in plain language and attach or point to your data.

Work in your project folder

With Claude or Codex, we recommend working in Claude Code or Codex, opened in the folder that holds your project data, rather than in a chat. The agent can then find and read the spreadsheets, PDFs and other data in that folder by itself, and write the EVS files next to them. In a chat you have to drag in each file one at a time.

Example Prompts

  • “Inspect the Excel spreadsheets and PDF files in this folder. What EVS data files can we create from these inputs?”
  • “Make an APDV file from samples.csv for benzene and TCE.”
  • “Make an EVS file from samples.xlsx for benzene and TCE.”
  • “Convert site.geo to a GMF file.”
  • “Validate borings.lsdv before I load it in EVS.”
  • “Turn this lithology log spreadsheet into a PGF file.”
  • “Convert lithology.pgf to LSDV, then to LPDV.”
  • “Build a GEO file from site.pgf. Here is the order of the layers from the top down.”
  • “Build a GEO file from site2.pgf. Attempt to pick the best layer ordering automatically.”
  • “Why does EVS reject this AIDV file?”
  • “Create a conversion report, including all assumptions and decisions made during our data file creation.”

Your agent asks before it guesses

EVS files must be exact, so the skills tell the agent never to assume a value that is not in your data. Expect questions like these before the agent writes a file.

  • Units. If the source data does not state them, the agent asks for coordinate units (meters or feet) and analyte concentration units (such as mg/L, ug/L or ppm). X, Y and Z in one file must use the same unit.
  • Elevation or depth. The agent asks whether Z values are elevations or depths below ground surface, and suggests an answer based on your data, such as a column named SampleDepth or values that increase down a boring.
  • Zero values. In an EVS file 0.0 is a measured value, not a non-detect. When a zero appears in units that EVS log processes, such as mg/kg or ug/L, the agent asks whether to write it as a non-detect or keep 0.0. Zeros in other units, such as pH or temperature, are kept.
  • Anything missing or ambiguous. Boring IDs, analyte names, layer names and other details are confirmed with you rather than assumed.

The agent also keeps your numbers as given and does not round coordinates, depths or values.

Conversions

Some conversions keep all of the data, some lose detail and some need your interpretation, such as turning lithology into geologic layers. The agent tells you which kind of conversion you are asking for, warns you about any data that will be lost and checks the converted file.

Earlier versions of the skills were installed on Windows with the C Tech EVS AI Skills installer (CTechAISkills.26.3.0.0.exe). That installer is no longer updated. The skills now ship as the EVS Data Tools plugin, which installs from CTechCorp/ai-plugins and updates through your agent.

The installer copied the skills into these folders in your user profile.

  • %USERPROFILE%\.claude\skills for Claude Code
  • %USERPROFILE%\.agents\skills for other agents
  • %USERPROFILE%\.copilot\skills for GitHub Copilot

Step 1. Uninstall the old skills

Uninstall the old skills first, so your agent does not load two copies of each skill.

  1. Open Windows Settings > Apps > Installed apps.
  2. Find C Tech EVS AI Skills and choose Uninstall.

The uninstaller removes the skill files it installed. If you copied the skills to other places yourself, remove the evs-* folders there too.

Step 2. Install EVS Data Tools

Install the plugin for each agent you use. See Install.

What changes

  • Updates. The installer never updated. The plugin updates through your agent, automatically or by hand. See Updates.
  • Names. In Claude Code the skills are namespaced by the plugin, for example /evs-data-tools:evs-data instead of /evs-data. Start each session with /evs-data-tools:evs-data. See Using the Skills.
  • License. The installer used the EVS End User License Agreement. EVS Data Tools is licensed under the separate C Tech AI Integrations License Agreement. See License.