freeark-skill

Query and operate FreeArk smart building HVAC systems via API tools.

1|Updated Oct 14, 2025
One-click install
npx skills add https://github.com/yangyang198354-haha/FreeArk --skill freeark-skill
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: freeark-skill
Source: https://github.com/yangyang198354-haha/FreeArk/tree/main/agents/freeark-skill
Command: npx skills add https://github.com/yangyang198354-haha/FreeArk --skill freeark-skill

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires freeark_client, and includes scripts (resource) components.

What problem does it solve?

The freeark-skill provides a set of API tools for querying and operating the FreeArk smart building system, automating tasks such as monitoring equipment status, managing services, and performing data analysis.

Core Features & Use Cases

  • Equipment Monitoring: Monitor device status, parameters, and PLC states.
  • Service Management: Retrieve system service status and perform restarts.
  • Data Analysis: Analyze energy usage, device performance, and fault counts.
  • Use Case: For example, use the skill to get the daily energy consumption for a specific device or to restart the FreeArk backend service.

Quick Start

Run the 'freeark-get-dashboard-summary' tool to retrieve the dashboard summary.

Frequently Asked Questions about freeark-skill

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I monitor smart building equipment status and PLC states?

You can monitor smart building equipment status and PLC states by using API tools to query device parameters and retrieve dashboard summaries for HVAC systems. This provides real-time visibility into equipment performance and operational states.

Can I retrieve daily energy consumption data for specific HVAC devices?

Yes, you can retrieve daily energy consumption data for specific HVAC devices by running data analysis API queries. This enables analysis of energy usage, device performance, and fault counts for smart building systems.

Do I need specific environment variables to access the FreeArk smart building API?

Yes, you need to configure appropriate environment variables for API access to operate the FreeArk smart building system. These credentials are required for both read-only monitoring queries and write operations like service management.

How do I restart backend services for a smart building system via API?

To restart backend services for a smart building system via API, you execute service management operations that retrieve system status and perform restarts. This requires write access credentials configured in your environment variables.

What's the best way to analyze fault counts and device performance in HVAC systems?

The best way to analyze fault counts and device performance in HVAC systems is using API tools that query operational data and generate performance summaries. This automates data analysis for smart building equipment monitoring and energy usage tracking.

Does the freeark_client dependency support both read-only and write operations?

Yes, the freeark_client dependency supports both read-only operations like equipment monitoring and write operations like service restarts. This enables comprehensive smart building system management including data analysis and service management.