@vantagesec/socc 0.1.13 → 0.1.15
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +8 -8
- package/dist/cli.mjs +10734 -10807
- package/package.json +7 -8
- package/scripts/bootstrap-socc-soul.mjs +23 -1
- package/socc-canonical/.agents/generated/socc-agent-manifest.json +0 -231
- package/socc-canonical/.agents/generated/socc-agent.md +0 -256
- package/socc-canonical/.agents/rules/AGENT.md +0 -109
- package/socc-canonical/.agents/rules/AQL_REFERENCE.md +0 -40
- package/socc-canonical/.agents/rules/MEMORY.md +0 -19
- package/socc-canonical/.agents/rules/TOOLS.md +0 -48
- package/socc-canonical/.agents/soc-copilot/AGENTS.md +0 -28
- package/socc-canonical/.agents/soc-copilot/MEMORY.md +0 -20
- package/socc-canonical/.agents/soc-copilot/SKILL.md +0 -51
- package/socc-canonical/.agents/soc-copilot/SOUL.md +0 -31
- package/socc-canonical/.agents/soc-copilot/TOOLS.md +0 -33
- package/socc-canonical/.agents/soc-copilot/USER.md +0 -31
- package/socc-canonical/.agents/soc-copilot/identity.md +0 -7
- package/socc-canonical/.agents/soc-copilot/references/evidence-rules.md +0 -30
- package/socc-canonical/.agents/soc-copilot/references/intelligence-source-registry.md +0 -32
- package/socc-canonical/.agents/soc-copilot/references/ioc-extraction.md +0 -25
- package/socc-canonical/.agents/soc-copilot/references/knowledge-ingestion-policy.md +0 -34
- package/socc-canonical/.agents/soc-copilot/references/mitre-guidance.md +0 -21
- package/socc-canonical/.agents/soc-copilot/references/output-contract.md +0 -31
- package/socc-canonical/.agents/soc-copilot/references/security-json-patterns.md +0 -129
- package/socc-canonical/.agents/soc-copilot/references/telemetry-investigation-patterns.md +0 -39
- package/socc-canonical/.agents/soc-copilot/schemas/analysis_response.json +0 -119
- package/socc-canonical/.agents/soc-copilot/skills/code-review-excellence/SKILL.md +0 -538
- package/socc-canonical/.agents/soc-copilot/skills/cybersecurity-analyst/QUICK_REFERENCE.md +0 -263
- package/socc-canonical/.agents/soc-copilot/skills/cybersecurity-analyst/README.md +0 -243
- package/socc-canonical/.agents/soc-copilot/skills/cybersecurity-analyst/SKILL.md +0 -1707
- package/socc-canonical/.agents/soc-copilot/skills/cybersecurity-analyst/tests/quiz.md +0 -472
- package/socc-canonical/.agents/soc-copilot/skills/data-visualization/SKILL.md +0 -304
- package/socc-canonical/.agents/soc-copilot/skills/deep-research/SKILL.md +0 -192
- package/socc-canonical/.agents/soc-copilot/skills/excel-analysis/SKILL.md +0 -247
- package/socc-canonical/.agents/soc-copilot/skills/find-skills/SKILL.md +0 -133
- package/socc-canonical/.agents/soc-copilot/skills/humanizer/README.md +0 -120
- package/socc-canonical/.agents/soc-copilot/skills/humanizer/SKILL.md +0 -439
- package/socc-canonical/.agents/soc-copilot/skills/malware-behavior/SKILL.md +0 -54
- package/socc-canonical/.agents/soc-copilot/skills/mitre/SKILL.md +0 -200
- package/socc-canonical/.agents/soc-copilot/skills/observability-logs-search/SKILL.md +0 -237
- package/socc-canonical/.agents/soc-copilot/skills/observability-logs-search/references/log-search-reference.md +0 -76
- package/socc-canonical/.agents/soc-copilot/skills/payload-triage/SKILL.md +0 -53
- package/socc-canonical/.agents/soc-copilot/skills/phishing-analysis/SKILL.md +0 -51
- package/socc-canonical/.agents/soc-copilot/skills/prd/SKILL.md +0 -143
- package/socc-canonical/.agents/soc-copilot/skills/remembering-conversations/MCP-TOOLS.md +0 -137
- package/socc-canonical/.agents/soc-copilot/skills/remembering-conversations/SKILL.md +0 -65
- package/socc-canonical/.agents/soc-copilot/skills/sequential-thinking/README.md +0 -118
- package/socc-canonical/.agents/soc-copilot/skills/sequential-thinking/SKILL.md +0 -93
- package/socc-canonical/.agents/soc-copilot/skills/sequential-thinking/references/advanced.md +0 -122
- package/socc-canonical/.agents/soc-copilot/skills/sequential-thinking/references/examples.md +0 -274
- package/socc-canonical/.agents/soc-copilot/skills/soc-generalist/SKILL.md +0 -53
- package/socc-canonical/.agents/soc-copilot/skills/suspicious-url/SKILL.md +0 -51
- package/socc-canonical/.agents/soc-copilot/skills/systematic-debugging/CREATION-LOG.md +0 -119
- package/socc-canonical/.agents/soc-copilot/skills/systematic-debugging/SKILL.md +0 -296
- package/socc-canonical/.agents/soc-copilot/skills/systematic-debugging/condition-based-waiting-example.ts +0 -158
- package/socc-canonical/.agents/soc-copilot/skills/systematic-debugging/condition-based-waiting.md +0 -115
- package/socc-canonical/.agents/soc-copilot/skills/systematic-debugging/defense-in-depth.md +0 -122
- package/socc-canonical/.agents/soc-copilot/skills/systematic-debugging/find-polluter.sh +0 -63
- package/socc-canonical/.agents/soc-copilot/skills/systematic-debugging/root-cause-tracing.md +0 -169
- package/socc-canonical/.agents/soc-copilot/skills/systematic-debugging/test-academic.md +0 -14
- package/socc-canonical/.agents/soc-copilot/skills/systematic-debugging/test-pressure-1.md +0 -58
- package/socc-canonical/.agents/soc-copilot/skills/systematic-debugging/test-pressure-2.md +0 -68
- package/socc-canonical/.agents/soc-copilot/skills/systematic-debugging/test-pressure-3.md +0 -69
- package/socc-canonical/.agents/soc-copilot/skills/translation-expertise/SKILL.md +0 -284
- package/socc-canonical/.agents/soc-copilot/skills/translation-expertise/chinese-traditional.md +0 -535
- package/socc-canonical/.agents/soc-copilot/skills/translation-expertise/english.md +0 -372
- package/socc-canonical/.agents/soc-copilot/skills/translation-expertise/japanese.md +0 -515
- package/socc-canonical/.agents/soc-copilot/skills/translation-expertise/tools-resources.md +0 -527
- package/socc-canonical/.agents/soc-copilot/skills/translation-expertise/translation-challenges.md +0 -603
- package/socc-canonical/.agents/soc-copilot/skills/web-search/SKILL.md +0 -322
- package/socc-canonical/.agents/soc-copilot/skills.md +0 -21
- package/socc-canonical/.agents/workflows/SOP.md +0 -137
- package/socc-canonical/README.md +0 -10
- /package/{.claude → .socc}/agents/socc.md +0 -0
- /package/{.claude → .socc}/references/evidence-rules.md +0 -0
- /package/{.claude → .socc}/references/intelligence-source-registry.md +0 -0
- /package/{.claude → .socc}/references/ioc-extraction.md +0 -0
- /package/{.claude → .socc}/references/knowledge-ingestion-policy.md +0 -0
- /package/{.claude → .socc}/references/mitre-guidance.md +0 -0
- /package/{.claude → .socc}/references/output-contract.md +0 -0
- /package/{.claude → .socc}/references/security-json-patterns.md +0 -0
- /package/{.claude → .socc}/references/telemetry-investigation-patterns.md +0 -0
- /package/{.claude → .socc}/rules/socc-business-rules.md +0 -0
- /package/{.claude → .socc}/skills/code-review-excellence/SKILL.md +0 -0
- /package/{.claude → .socc}/skills/cybersecurity-analyst/QUICK_REFERENCE.md +0 -0
- /package/{.claude → .socc}/skills/cybersecurity-analyst/README.md +0 -0
- /package/{.claude → .socc}/skills/cybersecurity-analyst/SKILL.md +0 -0
- /package/{.claude → .socc}/skills/cybersecurity-analyst/tests/quiz.md +0 -0
- /package/{.claude → .socc}/skills/data-visualization/SKILL.md +0 -0
- /package/{.claude → .socc}/skills/deep-research/SKILL.md +0 -0
- /package/{.claude → .socc}/skills/excel-analysis/SKILL.md +0 -0
- /package/{.claude → .socc}/skills/find-skills/SKILL.md +0 -0
- /package/{.claude → .socc}/skills/humanizer/README.md +0 -0
- /package/{.claude → .socc}/skills/humanizer/SKILL.md +0 -0
- /package/{.claude → .socc}/skills/malware-behavior/SKILL.md +0 -0
- /package/{.claude → .socc}/skills/mitre/SKILL.md +0 -0
- /package/{.claude → .socc}/skills/observability-logs-search/SKILL.md +0 -0
- /package/{.claude → .socc}/skills/observability-logs-search/references/log-search-reference.md +0 -0
- /package/{.claude → .socc}/skills/payload-triage/SKILL.md +0 -0
- /package/{.claude → .socc}/skills/phishing-analysis/SKILL.md +0 -0
- /package/{.claude → .socc}/skills/prd/SKILL.md +0 -0
- /package/{.claude → .socc}/skills/remembering-conversations/MCP-TOOLS.md +0 -0
- /package/{.claude → .socc}/skills/remembering-conversations/SKILL.md +0 -0
- /package/{.claude → .socc}/skills/sequential-thinking/README.md +0 -0
- /package/{.claude → .socc}/skills/sequential-thinking/SKILL.md +0 -0
- /package/{.claude → .socc}/skills/sequential-thinking/references/advanced.md +0 -0
- /package/{.claude → .socc}/skills/sequential-thinking/references/examples.md +0 -0
- /package/{.claude → .socc}/skills/soc-generalist/SKILL.md +0 -0
- /package/{.claude → .socc}/skills/suspicious-url/SKILL.md +0 -0
- /package/{.claude → .socc}/skills/systematic-debugging/CREATION-LOG.md +0 -0
- /package/{.claude → .socc}/skills/systematic-debugging/SKILL.md +0 -0
- /package/{.claude → .socc}/skills/systematic-debugging/condition-based-waiting-example.ts +0 -0
- /package/{.claude → .socc}/skills/systematic-debugging/condition-based-waiting.md +0 -0
- /package/{.claude → .socc}/skills/systematic-debugging/defense-in-depth.md +0 -0
- /package/{.claude → .socc}/skills/systematic-debugging/find-polluter.sh +0 -0
- /package/{.claude → .socc}/skills/systematic-debugging/root-cause-tracing.md +0 -0
- /package/{.claude → .socc}/skills/systematic-debugging/test-academic.md +0 -0
- /package/{.claude → .socc}/skills/systematic-debugging/test-pressure-1.md +0 -0
- /package/{.claude → .socc}/skills/systematic-debugging/test-pressure-2.md +0 -0
- /package/{.claude → .socc}/skills/systematic-debugging/test-pressure-3.md +0 -0
- /package/{.claude → .socc}/skills/translation-expertise/SKILL.md +0 -0
- /package/{.claude → .socc}/skills/translation-expertise/chinese-traditional.md +0 -0
- /package/{.claude → .socc}/skills/translation-expertise/english.md +0 -0
- /package/{.claude → .socc}/skills/translation-expertise/japanese.md +0 -0
- /package/{.claude → .socc}/skills/translation-expertise/tools-resources.md +0 -0
- /package/{.claude → .socc}/skills/translation-expertise/translation-challenges.md +0 -0
- /package/{.claude → .socc}/skills/web-search/SKILL.md +0 -0
|
@@ -1,247 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: Excel Analysis
|
|
3
|
-
description: Analyze Excel spreadsheets, create pivot tables, generate charts, and perform data analysis. Use when analyzing Excel files, spreadsheets, tabular data, or .xlsx files.
|
|
4
|
-
---
|
|
5
|
-
|
|
6
|
-
# Excel Analysis
|
|
7
|
-
|
|
8
|
-
## Quick start
|
|
9
|
-
|
|
10
|
-
Read Excel files with pandas:
|
|
11
|
-
|
|
12
|
-
```python
|
|
13
|
-
import pandas as pd
|
|
14
|
-
|
|
15
|
-
# Read Excel file
|
|
16
|
-
df = pd.read_excel("data.xlsx", sheet_name="Sheet1")
|
|
17
|
-
|
|
18
|
-
# Display first few rows
|
|
19
|
-
print(df.head())
|
|
20
|
-
|
|
21
|
-
# Basic statistics
|
|
22
|
-
print(df.describe())
|
|
23
|
-
```
|
|
24
|
-
|
|
25
|
-
## Reading multiple sheets
|
|
26
|
-
|
|
27
|
-
Process all sheets in a workbook:
|
|
28
|
-
|
|
29
|
-
```python
|
|
30
|
-
import pandas as pd
|
|
31
|
-
|
|
32
|
-
# Read all sheets
|
|
33
|
-
excel_file = pd.ExcelFile("workbook.xlsx")
|
|
34
|
-
|
|
35
|
-
for sheet_name in excel_file.sheet_names:
|
|
36
|
-
df = pd.read_excel(excel_file, sheet_name=sheet_name)
|
|
37
|
-
print(f"\n{sheet_name}:")
|
|
38
|
-
print(df.head())
|
|
39
|
-
```
|
|
40
|
-
|
|
41
|
-
## Data analysis
|
|
42
|
-
|
|
43
|
-
Perform common analysis tasks:
|
|
44
|
-
|
|
45
|
-
```python
|
|
46
|
-
import pandas as pd
|
|
47
|
-
|
|
48
|
-
df = pd.read_excel("sales.xlsx")
|
|
49
|
-
|
|
50
|
-
# Group by and aggregate
|
|
51
|
-
sales_by_region = df.groupby("region")["sales"].sum()
|
|
52
|
-
print(sales_by_region)
|
|
53
|
-
|
|
54
|
-
# Filter data
|
|
55
|
-
high_sales = df[df["sales"] > 10000]
|
|
56
|
-
|
|
57
|
-
# Calculate metrics
|
|
58
|
-
df["profit_margin"] = (df["revenue"] - df["cost"]) / df["revenue"]
|
|
59
|
-
|
|
60
|
-
# Sort by column
|
|
61
|
-
df_sorted = df.sort_values("sales", ascending=False)
|
|
62
|
-
```
|
|
63
|
-
|
|
64
|
-
## Creating Excel files
|
|
65
|
-
|
|
66
|
-
Write data to Excel with formatting:
|
|
67
|
-
|
|
68
|
-
```python
|
|
69
|
-
import pandas as pd
|
|
70
|
-
|
|
71
|
-
df = pd.DataFrame({
|
|
72
|
-
"Product": ["A", "B", "C"],
|
|
73
|
-
"Sales": [100, 200, 150],
|
|
74
|
-
"Profit": [20, 40, 30]
|
|
75
|
-
})
|
|
76
|
-
|
|
77
|
-
# Write to Excel
|
|
78
|
-
writer = pd.ExcelWriter("output.xlsx", engine="openpyxl")
|
|
79
|
-
df.to_excel(writer, sheet_name="Sales", index=False)
|
|
80
|
-
|
|
81
|
-
# Get worksheet for formatting
|
|
82
|
-
worksheet = writer.sheets["Sales"]
|
|
83
|
-
|
|
84
|
-
# Auto-adjust column widths
|
|
85
|
-
for column in worksheet.columns:
|
|
86
|
-
max_length = 0
|
|
87
|
-
column_letter = column[0].column_letter
|
|
88
|
-
for cell in column:
|
|
89
|
-
if len(str(cell.value)) > max_length:
|
|
90
|
-
max_length = len(str(cell.value))
|
|
91
|
-
worksheet.column_dimensions[column_letter].width = max_length + 2
|
|
92
|
-
|
|
93
|
-
writer.close()
|
|
94
|
-
```
|
|
95
|
-
|
|
96
|
-
## Pivot tables
|
|
97
|
-
|
|
98
|
-
Create pivot tables programmatically:
|
|
99
|
-
|
|
100
|
-
```python
|
|
101
|
-
import pandas as pd
|
|
102
|
-
|
|
103
|
-
df = pd.read_excel("sales_data.xlsx")
|
|
104
|
-
|
|
105
|
-
# Create pivot table
|
|
106
|
-
pivot = pd.pivot_table(
|
|
107
|
-
df,
|
|
108
|
-
values="sales",
|
|
109
|
-
index="region",
|
|
110
|
-
columns="product",
|
|
111
|
-
aggfunc="sum",
|
|
112
|
-
fill_value=0
|
|
113
|
-
)
|
|
114
|
-
|
|
115
|
-
print(pivot)
|
|
116
|
-
|
|
117
|
-
# Save pivot table
|
|
118
|
-
pivot.to_excel("pivot_report.xlsx")
|
|
119
|
-
```
|
|
120
|
-
|
|
121
|
-
## Charts and visualization
|
|
122
|
-
|
|
123
|
-
Generate charts from Excel data:
|
|
124
|
-
|
|
125
|
-
```python
|
|
126
|
-
import pandas as pd
|
|
127
|
-
import matplotlib.pyplot as plt
|
|
128
|
-
|
|
129
|
-
df = pd.read_excel("data.xlsx")
|
|
130
|
-
|
|
131
|
-
# Create bar chart
|
|
132
|
-
df.plot(x="category", y="value", kind="bar")
|
|
133
|
-
plt.title("Sales by Category")
|
|
134
|
-
plt.xlabel("Category")
|
|
135
|
-
plt.ylabel("Sales")
|
|
136
|
-
plt.tight_layout()
|
|
137
|
-
plt.savefig("chart.png")
|
|
138
|
-
|
|
139
|
-
# Create pie chart
|
|
140
|
-
df.set_index("category")["value"].plot(kind="pie", autopct="%1.1f%%")
|
|
141
|
-
plt.title("Market Share")
|
|
142
|
-
plt.ylabel("")
|
|
143
|
-
plt.savefig("pie_chart.png")
|
|
144
|
-
```
|
|
145
|
-
|
|
146
|
-
## Data cleaning
|
|
147
|
-
|
|
148
|
-
Clean and prepare Excel data:
|
|
149
|
-
|
|
150
|
-
```python
|
|
151
|
-
import pandas as pd
|
|
152
|
-
|
|
153
|
-
df = pd.read_excel("messy_data.xlsx")
|
|
154
|
-
|
|
155
|
-
# Remove duplicates
|
|
156
|
-
df = df.drop_duplicates()
|
|
157
|
-
|
|
158
|
-
# Handle missing values
|
|
159
|
-
df = df.fillna(0) # or df.dropna()
|
|
160
|
-
|
|
161
|
-
# Remove whitespace
|
|
162
|
-
df["name"] = df["name"].str.strip()
|
|
163
|
-
|
|
164
|
-
# Convert data types
|
|
165
|
-
df["date"] = pd.to_datetime(df["date"])
|
|
166
|
-
df["amount"] = pd.to_numeric(df["amount"], errors="coerce")
|
|
167
|
-
|
|
168
|
-
# Save cleaned data
|
|
169
|
-
df.to_excel("cleaned_data.xlsx", index=False)
|
|
170
|
-
```
|
|
171
|
-
|
|
172
|
-
## Merging and joining
|
|
173
|
-
|
|
174
|
-
Combine multiple Excel files:
|
|
175
|
-
|
|
176
|
-
```python
|
|
177
|
-
import pandas as pd
|
|
178
|
-
|
|
179
|
-
# Read multiple files
|
|
180
|
-
df1 = pd.read_excel("sales_q1.xlsx")
|
|
181
|
-
df2 = pd.read_excel("sales_q2.xlsx")
|
|
182
|
-
|
|
183
|
-
# Concatenate vertically
|
|
184
|
-
combined = pd.concat([df1, df2], ignore_index=True)
|
|
185
|
-
|
|
186
|
-
# Merge on common column
|
|
187
|
-
customers = pd.read_excel("customers.xlsx")
|
|
188
|
-
sales = pd.read_excel("sales.xlsx")
|
|
189
|
-
|
|
190
|
-
merged = pd.merge(sales, customers, on="customer_id", how="left")
|
|
191
|
-
|
|
192
|
-
merged.to_excel("merged_data.xlsx", index=False)
|
|
193
|
-
```
|
|
194
|
-
|
|
195
|
-
## Advanced formatting
|
|
196
|
-
|
|
197
|
-
Apply conditional formatting and styles:
|
|
198
|
-
|
|
199
|
-
```python
|
|
200
|
-
import pandas as pd
|
|
201
|
-
from openpyxl import load_workbook
|
|
202
|
-
from openpyxl.styles import PatternFill, Font
|
|
203
|
-
|
|
204
|
-
# Create Excel file
|
|
205
|
-
df = pd.DataFrame({
|
|
206
|
-
"Product": ["A", "B", "C"],
|
|
207
|
-
"Sales": [100, 200, 150]
|
|
208
|
-
})
|
|
209
|
-
|
|
210
|
-
df.to_excel("formatted.xlsx", index=False)
|
|
211
|
-
|
|
212
|
-
# Load workbook for formatting
|
|
213
|
-
wb = load_workbook("formatted.xlsx")
|
|
214
|
-
ws = wb.active
|
|
215
|
-
|
|
216
|
-
# Apply conditional formatting
|
|
217
|
-
red_fill = PatternFill(start_color="FF0000", end_color="FF0000", fill_type="solid")
|
|
218
|
-
green_fill = PatternFill(start_color="00FF00", end_color="00FF00", fill_type="solid")
|
|
219
|
-
|
|
220
|
-
for row in range(2, len(df) + 2):
|
|
221
|
-
cell = ws[f"B{row}"]
|
|
222
|
-
if cell.value < 150:
|
|
223
|
-
cell.fill = red_fill
|
|
224
|
-
else:
|
|
225
|
-
cell.fill = green_fill
|
|
226
|
-
|
|
227
|
-
# Bold headers
|
|
228
|
-
for cell in ws[1]:
|
|
229
|
-
cell.font = Font(bold=True)
|
|
230
|
-
|
|
231
|
-
wb.save("formatted.xlsx")
|
|
232
|
-
```
|
|
233
|
-
|
|
234
|
-
## Performance tips
|
|
235
|
-
|
|
236
|
-
- Use `read_excel` with `usecols` to read specific columns only
|
|
237
|
-
- Use `chunksize` for very large files
|
|
238
|
-
- Consider using `engine='openpyxl'` or `engine='xlrd'` based on file type
|
|
239
|
-
- Use `dtype` parameter to specify column types for faster reading
|
|
240
|
-
|
|
241
|
-
## Available packages
|
|
242
|
-
|
|
243
|
-
- **pandas** - Data analysis and manipulation (primary)
|
|
244
|
-
- **openpyxl** - Excel file creation and formatting
|
|
245
|
-
- **xlrd** - Reading older .xls files
|
|
246
|
-
- **xlsxwriter** - Advanced Excel writing capabilities
|
|
247
|
-
- **matplotlib** - Chart generation
|
|
@@ -1,133 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: find-skills
|
|
3
|
-
description: Helps users discover and install agent skills when they ask questions like "how do I do X", "find a skill for X", "is there a skill that can...", or express interest in extending capabilities. This skill should be used when the user is looking for functionality that might exist as an installable skill.
|
|
4
|
-
---
|
|
5
|
-
|
|
6
|
-
# Find Skills
|
|
7
|
-
|
|
8
|
-
This skill helps you discover and install skills from the open agent skills ecosystem.
|
|
9
|
-
|
|
10
|
-
## When to Use This Skill
|
|
11
|
-
|
|
12
|
-
Use this skill when the user:
|
|
13
|
-
|
|
14
|
-
- Asks "how do I do X" where X might be a common task with an existing skill
|
|
15
|
-
- Says "find a skill for X" or "is there a skill for X"
|
|
16
|
-
- Asks "can you do X" where X is a specialized capability
|
|
17
|
-
- Expresses interest in extending agent capabilities
|
|
18
|
-
- Wants to search for tools, templates, or workflows
|
|
19
|
-
- Mentions they wish they had help with a specific domain (design, testing, deployment, etc.)
|
|
20
|
-
|
|
21
|
-
## What is the Skills CLI?
|
|
22
|
-
|
|
23
|
-
The Skills CLI (`npx skills`) is the package manager for the open agent skills ecosystem. Skills are modular packages that extend agent capabilities with specialized knowledge, workflows, and tools.
|
|
24
|
-
|
|
25
|
-
**Key commands:**
|
|
26
|
-
|
|
27
|
-
- `npx skills find [query]` - Search for skills interactively or by keyword
|
|
28
|
-
- `npx skills add <package>` - Install a skill from GitHub or other sources
|
|
29
|
-
- `npx skills check` - Check for skill updates
|
|
30
|
-
- `npx skills update` - Update all installed skills
|
|
31
|
-
|
|
32
|
-
**Browse skills at:** https://skills.sh/
|
|
33
|
-
|
|
34
|
-
## How to Help Users Find Skills
|
|
35
|
-
|
|
36
|
-
### Step 1: Understand What They Need
|
|
37
|
-
|
|
38
|
-
When a user asks for help with something, identify:
|
|
39
|
-
|
|
40
|
-
1. The domain (e.g., React, testing, design, deployment)
|
|
41
|
-
2. The specific task (e.g., writing tests, creating animations, reviewing PRs)
|
|
42
|
-
3. Whether this is a common enough task that a skill likely exists
|
|
43
|
-
|
|
44
|
-
### Step 2: Search for Skills
|
|
45
|
-
|
|
46
|
-
Run the find command with a relevant query:
|
|
47
|
-
|
|
48
|
-
```bash
|
|
49
|
-
npx skills find [query]
|
|
50
|
-
```
|
|
51
|
-
|
|
52
|
-
For example:
|
|
53
|
-
|
|
54
|
-
- User asks "how do I make my React app faster?" → `npx skills find react performance`
|
|
55
|
-
- User asks "can you help me with PR reviews?" → `npx skills find pr review`
|
|
56
|
-
- User asks "I need to create a changelog" → `npx skills find changelog`
|
|
57
|
-
|
|
58
|
-
The command will return results like:
|
|
59
|
-
|
|
60
|
-
```
|
|
61
|
-
Install with npx skills add <owner/repo@skill>
|
|
62
|
-
|
|
63
|
-
vercel-labs/agent-skills@vercel-react-best-practices
|
|
64
|
-
└ https://skills.sh/vercel-labs/agent-skills/vercel-react-best-practices
|
|
65
|
-
```
|
|
66
|
-
|
|
67
|
-
### Step 3: Present Options to the User
|
|
68
|
-
|
|
69
|
-
When you find relevant skills, present them to the user with:
|
|
70
|
-
|
|
71
|
-
1. The skill name and what it does
|
|
72
|
-
2. The install command they can run
|
|
73
|
-
3. A link to learn more at skills.sh
|
|
74
|
-
|
|
75
|
-
Example response:
|
|
76
|
-
|
|
77
|
-
```
|
|
78
|
-
I found a skill that might help! The "vercel-react-best-practices" skill provides
|
|
79
|
-
React and Next.js performance optimization guidelines from Vercel Engineering.
|
|
80
|
-
|
|
81
|
-
To install it:
|
|
82
|
-
npx skills add vercel-labs/agent-skills@vercel-react-best-practices
|
|
83
|
-
|
|
84
|
-
Learn more: https://skills.sh/vercel-labs/agent-skills/vercel-react-best-practices
|
|
85
|
-
```
|
|
86
|
-
|
|
87
|
-
### Step 4: Offer to Install
|
|
88
|
-
|
|
89
|
-
If the user wants to proceed, you can install the skill for them:
|
|
90
|
-
|
|
91
|
-
```bash
|
|
92
|
-
npx skills add <owner/repo@skill> -g -y
|
|
93
|
-
```
|
|
94
|
-
|
|
95
|
-
The `-g` flag installs globally (user-level) and `-y` skips confirmation prompts.
|
|
96
|
-
|
|
97
|
-
## Common Skill Categories
|
|
98
|
-
|
|
99
|
-
When searching, consider these common categories:
|
|
100
|
-
|
|
101
|
-
| Category | Example Queries |
|
|
102
|
-
| --------------- | ---------------------------------------- |
|
|
103
|
-
| Web Development | react, nextjs, typescript, css, tailwind |
|
|
104
|
-
| Testing | testing, jest, playwright, e2e |
|
|
105
|
-
| DevOps | deploy, docker, kubernetes, ci-cd |
|
|
106
|
-
| Documentation | docs, readme, changelog, api-docs |
|
|
107
|
-
| Code Quality | review, lint, refactor, best-practices |
|
|
108
|
-
| Design | ui, ux, design-system, accessibility |
|
|
109
|
-
| Productivity | workflow, automation, git |
|
|
110
|
-
|
|
111
|
-
## Tips for Effective Searches
|
|
112
|
-
|
|
113
|
-
1. **Use specific keywords**: "react testing" is better than just "testing"
|
|
114
|
-
2. **Try alternative terms**: If "deploy" doesn't work, try "deployment" or "ci-cd"
|
|
115
|
-
3. **Check popular sources**: Many skills come from `vercel-labs/agent-skills` or `ComposioHQ/awesome-claude-skills`
|
|
116
|
-
|
|
117
|
-
## When No Skills Are Found
|
|
118
|
-
|
|
119
|
-
If no relevant skills exist:
|
|
120
|
-
|
|
121
|
-
1. Acknowledge that no existing skill was found
|
|
122
|
-
2. Offer to help with the task directly using your general capabilities
|
|
123
|
-
3. Suggest the user could create their own skill with `npx skills init`
|
|
124
|
-
|
|
125
|
-
Example:
|
|
126
|
-
|
|
127
|
-
```
|
|
128
|
-
I searched for skills related to "xyz" but didn't find any matches.
|
|
129
|
-
I can still help you with this task directly! Would you like me to proceed?
|
|
130
|
-
|
|
131
|
-
If this is something you do often, you could create your own skill:
|
|
132
|
-
npx skills init my-xyz-skill
|
|
133
|
-
```
|
|
@@ -1,120 +0,0 @@
|
|
|
1
|
-
# Humanizer
|
|
2
|
-
|
|
3
|
-
A Claude Code skill that removes signs of AI-generated writing from text, making it sound more natural and human.
|
|
4
|
-
|
|
5
|
-
## Installation
|
|
6
|
-
|
|
7
|
-
### Recommended (clone directly into Claude Code skills directory)
|
|
8
|
-
|
|
9
|
-
```bash
|
|
10
|
-
mkdir -p ~/.claude/skills
|
|
11
|
-
git clone https://github.com/blader/humanizer.git ~/.claude/skills/humanizer
|
|
12
|
-
```
|
|
13
|
-
|
|
14
|
-
### Manual install/update (only the skill file)
|
|
15
|
-
|
|
16
|
-
If you already have this repo cloned (or you downloaded `SKILL.md`), copy the skill file into Claude Code’s skills directory:
|
|
17
|
-
|
|
18
|
-
```bash
|
|
19
|
-
mkdir -p ~/.claude/skills/humanizer
|
|
20
|
-
cp SKILL.md ~/.claude/skills/humanizer/
|
|
21
|
-
```
|
|
22
|
-
|
|
23
|
-
## Usage
|
|
24
|
-
|
|
25
|
-
In Claude Code, invoke the skill:
|
|
26
|
-
|
|
27
|
-
```
|
|
28
|
-
/humanizer
|
|
29
|
-
|
|
30
|
-
[paste your text here]
|
|
31
|
-
```
|
|
32
|
-
|
|
33
|
-
Or ask Claude to humanize text directly:
|
|
34
|
-
|
|
35
|
-
```
|
|
36
|
-
Please humanize this text: [your text]
|
|
37
|
-
```
|
|
38
|
-
|
|
39
|
-
## Overview
|
|
40
|
-
|
|
41
|
-
Based on [Wikipedia's "Signs of AI writing"](https://en.wikipedia.org/wiki/Wikipedia:Signs_of_AI_writing) guide, maintained by WikiProject AI Cleanup. This comprehensive guide comes from observations of thousands of instances of AI-generated text.
|
|
42
|
-
|
|
43
|
-
### Key Insight from Wikipedia
|
|
44
|
-
|
|
45
|
-
> "LLMs use statistical algorithms to guess what should come next. The result tends toward the most statistically likely result that applies to the widest variety of cases."
|
|
46
|
-
|
|
47
|
-
## 24 Patterns Detected (with Before/After Examples)
|
|
48
|
-
|
|
49
|
-
### Content Patterns
|
|
50
|
-
|
|
51
|
-
| # | Pattern | Before | After |
|
|
52
|
-
|---|---------|--------|-------|
|
|
53
|
-
| 1 | **Significance inflation** | "marking a pivotal moment in the evolution of..." | "was established in 1989 to collect regional statistics" |
|
|
54
|
-
| 2 | **Notability name-dropping** | "cited in NYT, BBC, FT, and The Hindu" | "In a 2024 NYT interview, she argued..." |
|
|
55
|
-
| 3 | **Superficial -ing analyses** | "symbolizing... reflecting... showcasing..." | Remove or expand with actual sources |
|
|
56
|
-
| 4 | **Promotional language** | "nestled within the breathtaking region" | "is a town in the Gonder region" |
|
|
57
|
-
| 5 | **Vague attributions** | "Experts believe it plays a crucial role" | "according to a 2019 survey by..." |
|
|
58
|
-
| 6 | **Formulaic challenges** | "Despite challenges... continues to thrive" | Specific facts about actual challenges |
|
|
59
|
-
|
|
60
|
-
### Language Patterns
|
|
61
|
-
|
|
62
|
-
| # | Pattern | Before | After |
|
|
63
|
-
|---|---------|--------|-------|
|
|
64
|
-
| 7 | **AI vocabulary** | "Additionally... testament... landscape... showcasing" | "also... remain common" |
|
|
65
|
-
| 8 | **Copula avoidance** | "serves as... features... boasts" | "is... has" |
|
|
66
|
-
| 9 | **Negative parallelisms** | "It's not just X, it's Y" | State the point directly |
|
|
67
|
-
| 10 | **Rule of three** | "innovation, inspiration, and insights" | Use natural number of items |
|
|
68
|
-
| 11 | **Synonym cycling** | "protagonist... main character... central figure... hero" | "protagonist" (repeat when clearest) |
|
|
69
|
-
| 12 | **False ranges** | "from the Big Bang to dark matter" | List topics directly |
|
|
70
|
-
|
|
71
|
-
### Style Patterns
|
|
72
|
-
|
|
73
|
-
| # | Pattern | Before | After |
|
|
74
|
-
|---|---------|--------|-------|
|
|
75
|
-
| 13 | **Em dash overuse** | "institutions—not the people—yet this continues—" | Use commas or periods |
|
|
76
|
-
| 14 | **Boldface overuse** | "**OKRs**, **KPIs**, **BMC**" | "OKRs, KPIs, BMC" |
|
|
77
|
-
| 15 | **Inline-header lists** | "**Performance:** Performance improved" | Convert to prose |
|
|
78
|
-
| 16 | **Title Case Headings** | "Strategic Negotiations And Partnerships" | "Strategic negotiations and partnerships" |
|
|
79
|
-
| 17 | **Emojis** | "🚀 Launch Phase: 💡 Key Insight:" | Remove emojis |
|
|
80
|
-
| 18 | **Curly quotes** | `said “the project”` | `said "the project"` |
|
|
81
|
-
|
|
82
|
-
### Communication Patterns
|
|
83
|
-
|
|
84
|
-
| # | Pattern | Before | After |
|
|
85
|
-
|---|---------|--------|-------|
|
|
86
|
-
| 19 | **Chatbot artifacts** | "I hope this helps! Let me know if..." | Remove entirely |
|
|
87
|
-
| 20 | **Cutoff disclaimers** | "While details are limited in available sources..." | Find sources or remove |
|
|
88
|
-
| 21 | **Sycophantic tone** | "Great question! You're absolutely right!" | Respond directly |
|
|
89
|
-
|
|
90
|
-
### Filler and Hedging
|
|
91
|
-
|
|
92
|
-
| # | Pattern | Before | After |
|
|
93
|
-
|---|---------|--------|-------|
|
|
94
|
-
| 22 | **Filler phrases** | "In order to", "Due to the fact that" | "To", "Because" |
|
|
95
|
-
| 23 | **Excessive hedging** | "could potentially possibly" | "may" |
|
|
96
|
-
| 24 | **Generic conclusions** | "The future looks bright" | Specific plans or facts |
|
|
97
|
-
|
|
98
|
-
## Full Example
|
|
99
|
-
|
|
100
|
-
**Before (AI-sounding):**
|
|
101
|
-
> The new software update serves as a testament to the company's commitment to innovation. Moreover, it provides a seamless, intuitive, and powerful user experience—ensuring that users can accomplish their goals efficiently. It's not just an update, it's a revolution in how we think about productivity. Industry experts believe this will have a lasting impact on the entire sector, highlighting the company's pivotal role in the evolving technological landscape.
|
|
102
|
-
|
|
103
|
-
**After (Humanized):**
|
|
104
|
-
> The software update adds batch processing, keyboard shortcuts, and offline mode. Early feedback from beta testers has been positive, with most reporting faster task completion.
|
|
105
|
-
|
|
106
|
-
## References
|
|
107
|
-
|
|
108
|
-
- [Wikipedia: Signs of AI writing](https://en.wikipedia.org/wiki/Wikipedia:Signs_of_AI_writing) - Primary source
|
|
109
|
-
- [WikiProject AI Cleanup](https://en.wikipedia.org/wiki/Wikipedia:WikiProject_AI_Cleanup) - Maintaining organization
|
|
110
|
-
|
|
111
|
-
## Version History
|
|
112
|
-
|
|
113
|
-
- **2.1.1** - Fixed pattern #18 example (curly quotes vs straight quotes)
|
|
114
|
-
- **2.1.0** - Added before/after examples for all 24 patterns
|
|
115
|
-
- **2.0.0** - Complete rewrite based on raw Wikipedia article content
|
|
116
|
-
- **1.0.0** - Initial release
|
|
117
|
-
|
|
118
|
-
## License
|
|
119
|
-
|
|
120
|
-
MIT
|