ajshedivy/ifs
skills/ifs/SKILL.md
Browse, search, read, and inspect files in the IBM i Integrated File System (IFS) including authorities, locks, and server shares. Use when user asks about: (1) listing IFS directory contents, (2) searching for files by name or pattern, (3) reading text file contents, (4) checking file authorities or permissions, (5) diagnosing file lock contention, (6) finding large files consuming disk space, (7) viewing NetServer file shares, or (8) replacing WRKLNK, DSPAUT, DSPLNK command output.
$ install --global
skillsauthnpx skillsauth add ajshedivy/ibmi-agent-skills ifsInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 25, 2026, 5:32 AM52.8s4 files scanned
SKILL.md
- name:
- ifs
- description:
- Browse, search, read, and inspect files in the IBM i Integrated File System (IFS) including authorities, locks, and server shares. Use when user asks about: (1) listing IFS directory contents, (2) searching for files by name or pattern, (3) reading text file contents, (4) checking file authorities or permissions, (5) diagnosing file lock contention, (6) finding large files consuming disk space, (7) viewing NetServer file shares, or (8) replacing WRKLNK, DSPAUT, DSPLNK command output.
IBM i Integrated File System (IFS) Operations
Browse, search, read, and inspect files in the IFS including authorities, locks, and server shares using QSYS2 SQL services.
Available Tools
The ibmi CLI is the primary tool for IFS operations. Set SKILL_DIR to this skill's installed location (the directory containing this SKILL.md file):
# SKILL_DIR = directory containing this SKILL.md
# Examples: ./skills/ifs, ~/.claude/skills/ifs
ibmi tools --tools "$SKILL_DIR/tools/" --toolset ifs_default
ibmi tool list_ifs_directory --tools "$SKILL_DIR/tools/" --path /home
ibmi sql "SELECT PATH_NAME, DATA_SIZE FROM TABLE(QSYS2.IFS_OBJECT_STATISTICS(START_PATH_NAME => '/tmp', SUBTREE_DIRECTORIES => 'NO'))"
Service Selection Guide
Browsing & Search
- QSYS2.IFS_OBJECT_STATISTICS -- List directory contents, search by name, find large files
- QSYS2.SERVER_SHARE_INFO -- NetServer file and print shares
Security & Locks
- QSYS2.IFS_OBJECT_PRIVILEGES -- Authority settings for IFS objects
- QSYS2.IFS_OBJECT_LOCK_INFO -- Lock information and job contention
Content
- QSYS2.IFS_READ -- Read text file contents line by line
Key Capabilities
File Browsing
- Directory Listing -- List contents of any IFS directory with type, size, owner
- Recursive Search -- Find files matching name patterns across directory trees
- Large File Detection -- Identify biggest files consuming disk space
Security Analysis
- Authority Review -- Check read/write/execute authorities per user
- Lock Diagnosis -- Identify which jobs hold locks on files
- Owner Information -- Track file ownership across the IFS
Content Access
- Text File Reading -- Read configuration files, logs, scripts
- Share Management -- View NetServer shares and connection counts
Common Use Cases
- Browse directories -- List contents of /home, /tmp, or application paths
- Find files -- Search for configuration files, logs, or specific extensions
- Disk space analysis -- Find largest files in a directory tree
- Authority audit -- Check who has access to sensitive files
- Lock troubleshooting -- Identify jobs blocking file access
- Read config files -- View application configuration or properties files
- Share inventory -- List all NetServer file shares
Quick Examples
List root directory
ibmi tool list_ifs_directory --tools "$SKILL_DIR/tools/" --path /
Search for log files
ibmi tool search_ifs_by_name --tools "$SKILL_DIR/tools/" --path /home --name-pattern '%.log'
Read a text file
ibmi tool read_ifs_file --tools "$SKILL_DIR/tools/" --path /etc/hosts
Check file authorities
ibmi tool get_ifs_object_authorities --tools "$SKILL_DIR/tools/" --path /home/myuser
Pre-built Tools
The tools/ifs.yaml file provides 10 ready-to-use tools:
| Tool | Description |
|------|-------------|
| list_ifs_directory | List directory contents with type, size, owner |
| get_ifs_object_info | Detailed object info including journaling and CCSID |
| search_ifs_by_name | Recursive file search by name pattern |
| list_ifs_large_objects | Find largest files in a directory tree |
| get_ifs_object_authorities | Authority settings for IFS objects |
| read_ifs_file | Read text file contents line by line |
| list_ifs_object_locks | Lock information for file contention diagnosis |
| list_server_shares | NetServer file and print shares |
| compare_ifs_objects | Compare attributes and content of two IFS objects |
| list_ifs_job_info | IFS file handles held by a specific job |
ibmi tool <tool_name> --tools "$SKILL_DIR/tools/" # Execute
ibmi tool <tool_name> --tools "$SKILL_DIR/tools/" --dry-run # Preview SQL
ibmi tools show <tool_name> --tools "$SKILL_DIR/tools/" # View details
Reference Documentation
- IFS Services Catalog -- Available SQL services
- Example SQL Patterns -- Working query examples
- IBM IFS_OBJECT_STATISTICS -- Table function documentation
Related Skills
ajshedivy/work-management
tools
VerifiedTrustedCommunity
Query, monitor, and analyze jobs on IBM i using SQL table functions via the ibmi CLI. Use when user asks about: (1) finding jobs by status, user, subsystem, or type, (2) monitoring active job performance (CPU, I/O, memory), (3) detecting long-running SQL statements, (4) analyzing lock contention, (5) checking job queues, (6) scheduled jobs, (7) job logs, (8) replacing WRKACTJOB, WRKUSRJOB, WRKSBSJOB, WRKSBMJOB commands, or (9) any IBM i work management task.
2SKILL.mdUpdated Apr 2, 2026
ajshedivy/system-health
testing
VerifiedTrustedCommunity
Monitor IBM i system health including CPU, memory, disk, ASPs, system limits, and network status via SQL services. Use when user asks about: (1) CPU utilization or system status, (2) memory pool sizes or page faults, (3) disk capacity or ASP usage, (4) system limits approaching thresholds, (5) TCP/IP connections and network status, (6) system activity overview, (7) replacing WRKSYSSTS, WRKDSKSTS, WRKTCPSTS commands, or (8) any system health monitoring task.
2SKILL.mdUpdated Apr 2, 2026
ajshedivy/storage
development
VerifiedTrustedCommunity
Monitor and analyze IBM i storage resources including ASPs, disk units, temporary storage, user storage consumption, and NVMe devices via SQL services. Use when user asks about: (1) ASP capacity, usage, or health, (2) disk unit status or I/O performance, (3) temporary storage consumption by jobs, (4) storage used per user profile, (5) NVMe device health, (6) IASP vary operations, or (7) replacing WRKDSKSTS, WRKSYSSTS storage info, or WRKSTG commands.
2SKILL.mdUpdated Apr 2, 2026
ajshedivy/spool
testing
VerifiedTrustedCommunity
Manage and analyze spooled files, output queues, and printer configurations on IBM i via SQL services. Use when user asks about: (1) listing or searching output queues, (2) viewing spooled file entries by queue, user, or status, (3) reading spool file content, (4) identifying top spool consumers or old spool files, (5) printer file definitions, (6) spool storage analysis, (7) replacing WRKSPLF, WRKOUTQ, WRKOBJLCK commands, or (8) any spool file management task.
2SKILL.mdUpdated Apr 2, 2026