Add -Skip/-First compatibility to all line-range cmdlets (closes #41)

- Add -Skip and -First parameters to Show-TextFiles, Remove-LinesFromFile,
  Update-LinesInFile, and Update-MatchInFile
- Map to -LineRange internally via shared MapSkipFirstToLineRange() in base class
- Fix PlatyPS v2 Update-Help.ps1 API (Update-CommandHelp, Update-MarkdownModuleFile)
- Update PlatyPS help for new parameters
- Bump version to 1.7.6

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: yotsuda

PowerShell.MCP.Proxy/PowerShell.MCP.Proxy.csproj

@@ -5,7 +5,7 @@
     <TargetFramework>net9.0</TargetFramework>
     <ImplicitUsings>enable</ImplicitUsings>
     <Nullable>enable</Nullable>
-    <Version>1.7.5.0</Version>
+    <Version>1.7.6.0</Version>
     <NoWarn>$(NoWarn);NETSDK1206</NoWarn>
 
     <!-- Single File デプロイ設定 -->

PowerShell.MCP/Cmdlets/RemoveLinesFromFileCmdlet.cs

@@ -31,6 +31,12 @@ public class RemoveLinesFromFileCmdlet : TextFileCmdletBase
     [Parameter(ParameterSetName = "LiteralPath")]
     public string? Pattern { get; set; }
 
+    [Parameter]
+    public int? Skip { get; set; }
+
+    [Parameter]
+    public int? First { get; set; }
+
     [Parameter]
     public string? Encoding { get; set; }
 
@@ -42,6 +48,9 @@ public class RemoveLinesFromFileCmdlet : TextFileCmdletBase
 
     protected override void BeginProcessing()
     {
+        // -Skip/-First compatibility: map to -LineRange
+        LineRange = MapSkipFirstToLineRange(Skip, First, LineRange);
+
         // Contains and Pattern can be combined (OR condition), same as Show-TextFiles
 
         // Check that at least one of LineRange, Contains, or Pattern is specified

PowerShell.MCP/Cmdlets/ShowTextFilesCmdlet.cs

@@ -33,6 +33,12 @@ public class ShowTextFilesCmdlet : TextFileCmdletBase
     public string? Contains { get; set; }
 
 
+    [Parameter]
+    public int? Skip { get; set; }
+
+    [Parameter]
+    public int? First { get; set; }
+
     [Parameter]
     public SwitchParameter Recurse { get; set; }
 
@@ -85,6 +91,9 @@ protected override void BeginProcessing()
                 null));
         }
 
+        // -Skip/-First compatibility: map to -LineRange
+        LineRange = MapSkipFirstToLineRange(Skip, First, LineRange);
+
         // Pre-compile regex for performance (used across all files)
         // Combine Contains and Pattern with OR if both specified (single-line mode only)
         if (!_isMultilineContains && (!string.IsNullOrEmpty(Pattern) || !string.IsNullOrEmpty(Contains)))

PowerShell.MCP/Cmdlets/TextFileCmdletBase.cs

@@ -131,6 +131,51 @@ protected void ValidateLineRange(string[]? lineRange)
         }
     }
 
+    /// <summary>
+    /// Maps -Skip/-First to -LineRange. Returns the mapped LineRange value.
+    /// Throws terminating error for invalid combinations.
+    /// </summary>
+    protected string[]? MapSkipFirstToLineRange(int? skip, int? first, string[]? lineRange)
+    {
+        if (!skip.HasValue && !first.HasValue)
+            return lineRange;
+
+        if (lineRange != null)
+        {
+            ThrowTerminatingError(new ErrorRecord(
+                new ArgumentException(
+                    "Cannot use -Skip/-First together with -LineRange.\n" +
+                    "Use -LineRange alone.\n\n" +
+                    "Examples:\n" +
+                    "  -Skip 200 -First 50  -> -LineRange 201-250\n" +
+                    "  -First 20            -> -LineRange 1-20"),
+                "SkipFirstWithLineRange",
+                ErrorCategory.InvalidArgument,
+                null));
+        }
+
+        if (first.HasValue && first.Value <= 0)
+        {
+            ThrowTerminatingError(new ErrorRecord(
+                new ArgumentException("-First must be a positive integer."),
+                "FirstNotPositive",
+                ErrorCategory.InvalidArgument,
+                null));
+        }
+
+        int s = skip ?? 0;
+        int start = s + 1;
+
+        if (!first.HasValue)
+        {
+            // -Skip only: from start to end of file
+            return start <= 1 ? lineRange : new[] { $"{start},-1" };
+        }
+
+        int end = s + first.Value;
+        return new[] { $"{start}-{end}" };
+    }
+
     /// <summary>
     /// Validates that a parameter value does not contain newline characters
     /// </summary>

PowerShell.MCP/Cmdlets/UpdateLinesInFileCmdlet.cs

@@ -34,6 +34,12 @@ protected override object[]? ContentProperty
         set => Content = value;
     }
 
+    [Parameter]
+    public int? Skip { get; set; }
+
+    [Parameter]
+    public int? First { get; set; }
+
     [Parameter]
     public string? Encoding { get; set; }
 
@@ -42,6 +48,9 @@ protected override object[]? ContentProperty
 
     protected override void BeginProcessing()
     {
+        // -Skip/-First compatibility: map to -LineRange
+        LineRange = MapSkipFirstToLineRange(Skip, First, LineRange);
+
         InitializeContentAccumulation();
     }
 

PowerShell.MCP/Cmdlets/UpdateMatchInFileCmdlet.cs

@@ -32,6 +32,12 @@ public class UpdateMatchInFileCmdlet : TextFileCmdletBase
     [ValidateLineRange]
     public string[]? LineRange { get; set; }
 
+    [Parameter]
+    public int? Skip { get; set; }
+
+    [Parameter]
+    public int? First { get; set; }
+
     [Parameter]
     public string? Encoding { get; set; }
 
@@ -40,6 +46,8 @@ public class UpdateMatchInFileCmdlet : TextFileCmdletBase
 
     protected override void BeginProcessing()
     {
+        // -Skip/-First compatibility: map to -LineRange
+        LineRange = MapSkipFirstToLineRange(Skip, First, LineRange);
         bool hasLiteral = !string.IsNullOrEmpty(OldText);
         bool hasRegex = !string.IsNullOrEmpty(Pattern);
 

PowerShell.MCP/PlatyPS/Update-Help.ps1

@@ -32,7 +32,7 @@ foreach ($md in $mdFiles) {
     $cmdName = $cmdHelp.Title
     $cmdInfo = Get-Command $cmdName -Module PowerShell.MCP -ErrorAction SilentlyContinue
     if ($cmdInfo) {
-        Update-MarkdownCommandHelp -Path $md.FullName -CommandInfo $cmdInfo -Force
+        Update-CommandHelp -Path $md.FullName
         Write-Host "  Updated: $($md.Name)" -ForegroundColor Gray
     } else {
         Write-Warning "  Skipped: $($md.Name) (command not found)"
@@ -42,7 +42,8 @@ foreach ($md in $mdFiles) {
 # Update module page
 $modulePage = Join-Path $markdownPath "PowerShell.MCP.md"
 if (Test-Path $modulePage) {
-    Update-MarkdownModuleFile -Path $modulePage -ModuleInfo (Get-Module PowerShell.MCP) -Force
+    $commandHelps = $mdFiles | ForEach-Object { Import-MarkdownCommandHelp -Path $_.FullName }
+    Update-MarkdownModuleFile -Path $modulePage -CommandHelp $commandHelps -Force
     Write-Host "  Updated: PowerShell.MCP.md" -ForegroundColor Gray
 }
 

PowerShell.MCP/PlatyPS/en-US/PowerShell.MCP.md

@@ -5,7 +5,7 @@ HelpInfoUri: https://github.com/yotsuda/PowerShell.MCP#readme
 Locale: ja-JP
 Module Guid: 313962fa-c90b-424a-9c8a-d4a05f4a1481
 Module Name: PowerShell.MCP
-ms.date: 04/01/2026
+ms.date: 04/05/2026
 PlatyPS schema version: 2024-05-01
 title: PowerShell.MCP Module
 ---
@@ -16,28 +16,12 @@ title: PowerShell.MCP Module
 
 The universal MCP server for Claude Code and other MCP-compatible clients. One installation gives AI access to 10,000+ PowerShell modules and any CLI tool. You and AI collaborate in the same console with full transparency. Supports Windows, Linux, and macOS.
 
-## PowerShell.MCP
+## PowerShell.MCP Cmdlets
 
 ### [Add-LinesToFile](Add-LinesToFile.md)
 
 Insert lines into a text file at a specific position or at the end
 
-### [Remove-LinesFromFile](Remove-LinesFromFile.md)
-
-Remove lines from a text file by line range or pattern matching
-
-### [Show-TextFiles](Show-TextFiles.md)
-
-Display file contents with line numbers, or search across files with regex or literal patterns
-
-### [Update-LinesInFile](Update-LinesInFile.md)
-
-Replace or delete specific lines in a text file
-
-### [Update-MatchInFile](Update-MatchInFile.md)
-
-Replace text in a file using literal string or regex pattern
-
 ### [Get-MCPOwner](Get-MCPOwner.md)
 
 Gets information about the MCP client that owns this console.
@@ -54,7 +38,23 @@ Registers PowerShell.MCP as an MCP server in Claude Code.
 
 Registers PowerShell.MCP as an MCP server in Claude Desktop.
 
+### [Remove-LinesFromFile](Remove-LinesFromFile.md)
+
+Remove lines from a text file by line range or pattern matching
+
+### [Show-TextFiles](Show-TextFiles.md)
+
+Display file contents with line numbers, or search across files with regex or literal patterns
+
 ### [Stop-AllPwsh](Stop-AllPwsh.md)
 
 Stops all pwsh processes to release DLL locks.
 
+### [Update-LinesInFile](Update-LinesInFile.md)
+
+Replace or delete specific lines in a text file
+
+### [Update-MatchInFile](Update-MatchInFile.md)
+
+Replace text in a file using literal string or regex pattern
+

PowerShell.MCP/PlatyPS/en-US/Remove-LinesFromFile.md

@@ -20,15 +20,15 @@ Remove lines from a text file by line range or pattern matching
 ### Path
 
 ```
-Remove-LinesFromFile [-Path] <string[]> [-LineRange <string[]>] [-Contains <string>]
- [-Pattern <string>] [-Encoding <string>] [-Backup] [-WhatIf] [-Confirm] [<CommonParameters>]
+Remove-LinesFromFile [-Path] <string[]> [-LineRange <string[]>] [-Skip <int>] [-First <int>]
+ [-Contains <string>] [-Pattern <string>] [-Encoding <string>] [-Backup] [-WhatIf] [-Confirm] [<CommonParameters>]
 ```
 
 ### LiteralPath
 
 ```
-Remove-LinesFromFile -LiteralPath <string[]> [-LineRange <string[]>] [-Contains <string>]
- [-Pattern <string>] [-Encoding <string>] [-Backup] [-WhatIf] [-Confirm] [<CommonParameters>]
+Remove-LinesFromFile -LiteralPath <string[]> [-LineRange <string[]>] [-Skip <int>] [-First <int>]
+ [-Contains <string>] [-Pattern <string>] [-Encoding <string>] [-Backup] [-WhatIf] [-Confirm] [<CommonParameters>]
 ```
 
 ## ALIASES
@@ -137,6 +137,52 @@ AcceptedValues: []
 HelpMessage: ''
 ```
 
+### -First
+
+Number of lines to process.
+Use with `-Skip` to define a range, or alone to process from the beginning.
+Mapped to `-LineRange` internally (e.g., `-First 20` becomes `-LineRange 1-20`).
+
+```yaml
+Type: System.Nullable`1[System.Int32]
+DefaultValue: None
+SupportsWildcards: false
+Aliases: []
+ParameterSets:
+- Name: (All)
+  Position: Named
+  IsRequired: false
+  ValueFromPipeline: false
+  ValueFromPipelineByPropertyName: false
+  ValueFromRemainingArguments: false
+DontShow: false
+AcceptedValues: []
+HelpMessage: ''
+```
+
+### -Skip
+
+Number of lines to skip from the beginning.
+Use with `-First` to define a window (e.g., `-Skip 200 -First 50` becomes `-LineRange 201-250`).
+Use alone to skip lines and process to end of file (e.g., `-Skip 100` becomes `-LineRange 101,-1`).
+
+```yaml
+Type: System.Nullable`1[System.Int32]
+DefaultValue: None
+SupportsWildcards: false
+Aliases: []
+ParameterSets:
+- Name: (All)
+  Position: Named
+  IsRequired: false
+  ValueFromPipeline: false
+  ValueFromPipelineByPropertyName: false
+  ValueFromRemainingArguments: false
+DontShow: false
+AcceptedValues: []
+HelpMessage: ''
+```
+
 ### -Encoding
 
 Character encoding.

PowerShell.MCP/PlatyPS/en-US/Show-TextFiles.md

@@ -20,15 +20,15 @@ Display file contents with line numbers, or search across files with regex or li
 ### Path
 
 ```
-Show-TextFiles [-Path] <string[]> [-LineRange <string[]>] [-Pattern <string>] [-Contains <string>]
- [-Recurse] [-Encoding <string>] [<CommonParameters>]
+Show-TextFiles [-Path] <string[]> [-LineRange <string[]>] [-Skip <int>] [-First <int>]
+ [-Pattern <string>] [-Contains <string>] [-Recurse] [-Encoding <string>] [<CommonParameters>]
 ```
 
 ### LiteralPath
 
 ```
-Show-TextFiles -LiteralPath <string[]> [-LineRange <string[]>] [-Pattern <string>]
- [-Contains <string>] [-Recurse] [-Encoding <string>] [<CommonParameters>]
+Show-TextFiles -LiteralPath <string[]> [-LineRange <string[]>] [-Skip <int>] [-First <int>]
+ [-Pattern <string>] [-Contains <string>] [-Recurse] [-Encoding <string>] [<CommonParameters>]
 ```
 
 ## ALIASES
@@ -96,6 +96,52 @@ AcceptedValues: []
 HelpMessage: ''
 ```
 
+### -First
+
+Number of lines to process.
+Use with `-Skip` to define a range, or alone to process from the beginning.
+Mapped to `-LineRange` internally (e.g., `-First 20` becomes `-LineRange 1-20`).
+
+```yaml
+Type: System.Nullable`1[System.Int32]
+DefaultValue: None
+SupportsWildcards: false
+Aliases: []
+ParameterSets:
+- Name: (All)
+  Position: Named
+  IsRequired: false
+  ValueFromPipeline: false
+  ValueFromPipelineByPropertyName: false
+  ValueFromRemainingArguments: false
+DontShow: false
+AcceptedValues: []
+HelpMessage: ''
+```
+
+### -Skip
+
+Number of lines to skip from the beginning.
+Use with `-First` to define a window (e.g., `-Skip 200 -First 50` becomes `-LineRange 201-250`).
+Use alone to skip lines and process to end of file (e.g., `-Skip 100` becomes `-LineRange 101,-1`).
+
+```yaml
+Type: System.Nullable`1[System.Int32]
+DefaultValue: None
+SupportsWildcards: false
+Aliases: []
+ParameterSets:
+- Name: (All)
+  Position: Named
+  IsRequired: false
+  ValueFromPipeline: false
+  ValueFromPipelineByPropertyName: false
+  ValueFromRemainingArguments: false
+DontShow: false
+AcceptedValues: []
+HelpMessage: ''
+```
+
 ### -Encoding
 
 Character encoding.