SKILL.md - Text Classifier

Upload text or CSV — AI automatically classifies content and returns structured labels with confidence scores.

Slug: text-classifier

Tiered Features

| Feature | FREE | PRO | |---------|:----:|:---:| | Text input | ✅ | ✅ | | File upload (TXT/CSV) | ❌ | ✅ | | Preset classifiers | 3 | Unlimited | | Custom labels | ❌ | ✅ | | Confidence score | ❌ | ✅ | | Batch processing | ❌ | ✅ (up to 5,000) | | History retention | ❌ | ✅ (365 days) | | Daily classifications | 20 | Unlimited |

Pricing

Per-call: $0.01 USDT per classification

No monthly subscription. Pay only for what you use.

Usage

Web Interface (Recommended)

cd text-classifier
pip install -r requirements.txt
python scripts/web_app.py
# Open http://localhost:5000

CLI

# Single text classification
python -m scripts.classifier --text "This product is great" --classifier "Sentiment Classification" --api-key "sk-..."

# Batch CSV classification
python -m scripts.classifier --file data.csv --classifier "Sentiment Classification" --api-key "sk-..." --output csv --output-path results.csv

# Custom labels
python -m scripts.classifier --text "Urgent issue" --custom-labels "High,Medium,Low" --custom-prompt "Classify priority" --api-key "sk-..."

Python API

from scripts.classifier import classify_text, validate_token

# Token validation
tier = validate_token("PRO-xxxx")
print(f"Tier: {tier}")

# Single classification
result = classify_text(
    text="This product is excellent",
    classifier_name="Sentiment Classification",
    api_key="sk-...",
    show_confidence=True
)
print(result)
# {'label': 'Positive', 'confidence': 0.85, 'raw': 'Positive', ...}

Preset Classifiers

• Intent Classification: Inquiry / Complaint / Refund / Cooperation
• Sentiment Classification: Positive / Neutral / Negative
• Industry Classification: Finance / Healthcare / Education / Retail / Manufacturing
• Risk Classification: Compliant / Violation / Suspicious
• Priority Classification: High / Medium / Low
• Content Classification: News / Advertisement / UGC / Spam

Required Environment Variables

SKILL_BILLING_API_KEY   # Your SkillPay Builder API Key
SKILL_BILLING_SKILL_ID  # Skill slug: text-classifier

Set these in your runtime environment. Without them, the tool runs in Dev Mode (FREE tier, no billing).

Billing

This skill uses SkillPay (skillpay.me) for per-call billing at $0.01 USDT per classification.

• Your Feishu User ID (Open ID) is transmitted to skillpay.me exclusively for billing purposes
• No other data is transmitted to third parties
• Billing occurs at the start of each classification (after API key validation)
• Dev Mode (SKILL_BILLING_API_KEY not set): FULL FREE USAGE — no API key required, no billing

Security Notes

• LLM Execution: All AI classification runs via OpenAI API you configure
• Data Isolation: Classification history is stored locally in /tmp/text-classifier/ — no data leaves your environment
• SQL Safety: Not applicable (no database queries in this skill)
• Path Isolation: All writes go to /tmp/ — no home directory access

Dependencies

requests>=2.28.0
pandas>=2.0.0
openpyxl>=3.0.0
flask>=3.0.0